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ABSTRACT 


Having timely and accurate information 1s essential for effective management 
practices and optimization of limited resources. Information is scattered throughout 
organizations and must be easily accessible. A new solution is needed for effective and 
efficient management of data in today's distributed client/server environment. 

Java is destined to become a language for distributed computing. J ava 
Development Kit (JDK) comes with a broad range of classes for network and database 
programming. Java Database Connectivity (JDBC) 1s one such class for providing 
client/server database access. There are many different approaches in using JDBC, 
ranging from low level socket programming, to a more abstract middleware approach. 
This thesis will analyze three different approaches: Sockets, Remote Method Invocation 
(RMI) and Commercial Middleware servers. 

Among the three approaches this thesis examined, database access through RMI 1s 
the most viable approach because it uses an effective distributed object model. RMI 
abstracts the communication interface to the level of a procedure call. Instead of working 


directly with sockets, programmers can invoke a remote procedure as if it resided locally. 
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L INTRODUCTION 


Organizations rely on information to make effective business decisions and 
corporate intranets are changing the way organizations conduct business. As networking 
technologies continue to improve, with increasing bandwidth and reliability, effective 
distributed computing is becoming a reality. Organizations are relying on internet 
technologies to be the conduit for employees to access and manipulate corporate 
information. 

Having timely and accurate information is essential for effective management 
practices and optimization of limited resources. Information can be stored effectively 
and efficiently in Database Management Systems (DBMS), a software system that 
manages the data integrity, storage and access of data in a database. 

The goal of a database 1s to reduce redundant storage of information throughout 
an organization. Data is stored in a central location and multiple clients are allowed to 
access the data from various locations throughout the organization's network or via the 
internet. In this client/server environment, client processes need to be able to effectively 
locate the database server, and communicate with the remote server process. 

A database aware client/server system is a system that allows client process to 
access a server process, which in turn communicates with a database management 
system. The client can manipulate the data, but the location of the database and the type 
of DBMS used is transparent. There are a number of challenges in implementing a 
database aware client/server system. Information needs to be accessible from various 
client operating systems and possibly via the internet and a web browser. The networking 
protocol, how information 1s transported from a client machine to a server machine, must 
be agreed by both the client and server process. System designers must be able to 
communicate with the DBMS, via an agreed upon interface. Optimization of resources, a 
high return on investment, is essential in justifying implementing a database aware 
client/server solution to various corporate managers. Organizations want to keep system 
development and maintenance costs as low as possible. As system designers perform 


their problem analysis these issues need to be addressed. 
A. POTENTIAL SOLUTION 


The programming language selected must facilitate a designers ability to meet the 


above challenges. Java, developed by Sun Microsystems is an object-oriented network 


centric programming language that is poised to enter the Enterprise Client/Server 
environment. 

Java provides the platform independence that may be demanded. A Java 
application can run on any platform that has a Java Virtual Machine. This reduces the 
costs and time associated with generating multiple versions of an application to run on 
various platforms. Applications can easily be modified to create Java applets, which are 
hosted by a Java-enabled web browser. This added flexibility allows an organization to 
re-use programs and make them available via their intranet or the internet. System 
administrators are not required to configure client machines, since all required class files 
will be downloaded from the server. Any changes to the applet will result in the user 
getting the most recent version, so will ultimately reduce software distribution expenses. 

The java.net package provides a powerful and flexible infrastructure for 
networking. The designer can use datagram sockets or stream sockets to send 
information between two processes. The package also allows the designer to create a 
multicast group, which allows a process to join a group. A message sent to the group will 
be received by all group members. This implementation requires the designer to 
implement a message passing protocol that will be used between processes. The message 
passing protocol provides a means for the recipient process to understand what to do 
with the message. 

Java Remote Method Invocation is a distributed model that can be found in the 
java.rmi package. It encapsulates the low level socket requirements and message 
passing. A Java client application will establish a reference to a remote Java server 
object and issue method calls as if the remote object resided locally. This higher level of 
abstraction allows a Java client to talk with a Java remote object. 

The java.sql package provides a means for Java applications to interface with 
Relational Database Management Systems. The functionality provided by this package 1s 
referred to as Java Database Connectivity (JDBC) and was introduced by Sun with Java 
Development Kit version 1.1. Relational database access accounts for the majority of 
client/server programs being employed by organizations. This package passes SQL 
statements to a Relational DBMS via a Java Database Driver. 

By using Java technologies, organizations can maximize resource utilization. 
Proficient Java Developers can provide total solutions to include: developing a user 
interface, networking, and database access requirements. Conventional database interface 
developers are required to understand vendor specific database interface tools, and 1f web 


based access is required, then they must understand Common Gateway Interface (CGI). 


Version control is simplified with Java due to it's platform independence. A Java 
database aware application is designed to run on a Java Virtual Machine, which has been 
implemented on many hardware platforms and integrated into numerous web browsers. 
This relieves the designers from being overly concerned about the target platform, 
allowing them to focus on application functionality and efficiency. System administrators 
will be satisfied because application deployment requires minimal client configuration, 
and can be downloaded via an application installation applet. The client downloads the 
application or applet, and depending upon how the database system was designed, may 


not be required to install any database specific drivers. 
B. RESEARCH OBJECTIVES 


Java technologies are promising but are still immature. Enterprises are just 
beginning to exploit the potential of using Java in distributed applications. This thesis 
will study three approaches to using Java technologies to interface with a relational 
DBMS. We will first examine how JDBC can be utilized to access various relational 
DBMS. The thesis will then focus on how JDBC can be used with various networking 
technologies to establish a distributed database aware system. Part of the analysis of each . 
approach will be to develop a working prototype which can be used as a basis for an 
actual implementation and for further evaluation of the potential for Enterprise Java 
technologies. 

The primary objective of this thesis 1s to explore how Java technologies are used 
to access relational databases. Other concerns are to assess the functionality and the ease 
of using the JDBC interface. In order to develop a client/server system we are going to 
assess how a designer can implement a Java solution in a distributed environment using 
Java sockets, Remote Method Invocation and through a middleware solution. We plan on 
using and assessing two middleware JDBC drivers: Borland's DataGateway and 
Symantec's dbAnywhere, to determine how effective they are in connecting Java client 


applications to relational DBMS's. 


C. SCOPE 


The scope of the thesis will be to determine the effectiveness of Java technology 
to meet interface designers, system administrators, and users requirements in accessing a 
relational data base management system. The first phase of this thesis 1s to develop an 


understanding of the JDBC classes and methods provided in the java.sql package. The 


next phase is to create an evaluation client/server environment for testing various 
implementations of connecting to a DBMS. This phase will include installing and 
configuring both local and remote database management systems such as Microsoft 
Access, Microsoft SQL 6.5 and Sybase SQLAnywhere. The third phase will focus on 
network connectivity issues such as using sockets, or remote method invocation to access 
a remote database server. The fourth phase will be to use two existing middleware 
solutions: Borland's DataGateway and Symantec's dbAnywhere and to evaluate their 
effectiveness in providing a Java database aware client/server solution. Finally, a 


summary of the lessons learned and recommended future work are provided. 


D. THESIS ORGANIZATION 


This thesis 1s organized into the following chapters: 

e Chapter I: Introduction. This chapter gives an introduction to the problem, 
motivation, purpose, and general outline of the work. 

e Chapter Il: Background. This chapter is intended to provide an overview of the 
concepts used throughout the thesis. An explanation of relational database model, 
Structured Query Language, database application programming interfaces, and 
client/server model will be provided. 

e Chapter III: Java Database Connectivity. This chapter describes the JDBC API 
and its key classes and methods and how they interact with a client application or 
database management system to provide database functionality. The four classes 
of JDBC drivers are described along with the advantages and disadvantages of 
using each to link a Java application to a relational database. Once a solid 
understanding of how JDBC can be used to interface with relational databases, the 
next phase is to assess various ways of connecting to the database server. 

e Chapter IV: Socket and JDBC. This chapter will provide an overview of using 
Java sockets to provide a low level communication link between a client and a 
JDBC aware server. A model is implemented using multicast sockets replicating 
a distributed Corporate parts databases, where each department database server is 


part of a multicast group. 


Chapter V: Remote Method Invocation and JDBC. This chapter will employ RMI 
which encapsulates the low level details of socket programming for network 
communication. All JDBC drivers will reside on the server, which will interface 
with three different databases: a MS Access accounting database, a MS SQL 6.5 
Navy database, and a Sybase SQL Anywhere demo database. 

Chapter VI: Middleware and JDBC. This chapter will look at the benefits and 
limitations of using two middleware solutions: Borland's DataGateway and 
Symantec's db Anywhere. These two competing JDBC drivers allow a Java client 
to talk through the middleware driver to various SQL databases. 

Chapter VII: Conclusion. An overall assessment will be made on using Java 
technologies to develop a connection to a relational database. The strengths of 
sockets, RMI, and the use of a middleware solution will be analyzed. 


Recommendations for future research will also be made. 





II. BACKGROUND 


In this chapter, we provide the background information necessary for readers to 
understand this thesis. We will describe: relational database model, structured query 
language, application programming interfaces to databases, and distributed computing in 


a client server environment. 
A. RELATIONAL DATABASE MODEL 


A database is defined as a collection of related data. A relational model is a 
database model in which all data is held in tables, which are made up of rows and 
columns. Each table has one or more columns and each column is assigned a specific 
data type such as integer, characters, or date. Each column has a label which identifies 
the column, for example "employee id". 

Each table in a database has a unique column value, known as a primary key. 
Primary keys are used to uniquely identify a particular row of data. For example, a 
persons social security number may be used as the primary key for an employee table. A 
row of data in a table is known as a tuple or a record. So each table will contain 
numerous records. 

Foreign keys are used to define relationships between tables. A foreign key is a 
reference to a particular row in a different table that carrys the corresponding primary 
key. For example, a department table may have a manager column, which contains the 
social security number of the manager. This column represent a foreign key to the 
primary key, social security number, of the employee table. A table can be related to one 


or more tables based upon the relationships between primary keys and foreign keys. 
B. STRUCTURED QUERY LANGUAGE 


Structured Query Language is a declarative language that is used to manipulate 
relational databases. SQL is a standard for relational database operations, not a 
communication protocol. It has no knowledge about how the database engine retrieves or 
processes the SQL statement. This results in a natural separation between the database 
management system that manages the data, and the client which determines what data to 
manipulate. 

The ANSI standard for SQL (ANSI X3.135.1) defines level 1 and level 2 
compliance. Level 1 consists of a Data Definition Language (DDL) and Data 
Manipulation Language (DML). The DDL includes functions such as CREATE, 


ALTER, PRIMARY KEY and FOREIGN KEY. DML extends that functionality to 
include SELECT, INSERT, DELETE, which operate on rows and columns within a table. 
Level 1 also defines a cursor capability that can be used by a program for processing 
rows one at a time. Level 2 compliance consists of Level 1 and the Data Command 
Language (DCL) commands. DCL includes COMMIT, ROLLBACK, and GRANT, 


which control security, integrity, concurrency, and recovery of the database [Ref. 22]. 
1. Basic SQL Statements 


This section provides a sample of basic SQL commands that are used to 


manipulate a database. 
a. Create Table 


A two dimensional table is used to abstractly view data. Each table has a 
name and attributes of various data types, such as character, date or integer. , The 
attributes represent the column labels associated with the table. The following SQL 
statement creates a table whose name is myTable, which contains two attributes: name, of 


type character with a maximum length of 40 and dept, of type integer. 


CREATE TABLE myTable (name CHAR(40), dept INT) 
b. Insert 


The SQL insert operation inserts data into an existing table. The user must 
specify the table name, the column names, and the corresponding values to be inserted 
into the table. 


INSERT INTO myTable (name, dept) VALUES ('Fred', 23) 
c. Update 


Update is used to modify existing information in a table. The following 
example updates the dept field for any tuple with a name of Fred in the table, myTable. 
If multiple tuples with the name of Fred exist, they all will be modified. 


UPDATE myTable SET dept = 28 WHERE name = 'Fred' 


d. Delete 


This command removes an entire row (tuple) from the specified table. It 
can also be used to remove an entire table. The following sample would delete any tuples 


that have a dept identifier of 23 from myTable. 


DELETE FROM myTable WHERE dept = 23 
e. Select 


Select statements are used to extract data from various tables based upon 


search criteria, returning the result set. 


SELECT dept FROM myTable WHERE name = 'Fred' 
2. Processing a SQL Statement 


SQL statements can result in computationally expensive function calls. For 
example, a complex join operation between two or more large tables. It is important that 
system designers have a general understanding of how a database management system 
processes an SQL statement. To process an SQL statement, a DBMS performs four basic 
steps: Parse the SQL statement, Validate the statement, Generate an Access Plan, and 


Execute the Plan. 
a. Parse the SQL Statement 


The DBMS first parses the SQL statement. It breaks the statement up into 
individual words, called tokens, makes sure that the statement has a valid verb and valid 
clauses, and so on. Syntax errors and misspellings can be detected in this step. Parsing a 
SQL statement does not require access to the database and typically can be done very 
quickly. It ensures the SQL statement is in the database specific format. This phase 
ensures that the statement is syntactically correct. It is not concerned with the semantics 
of the statement, the parameters such as table names or types. It is only ensuring the 


statement 1s in the correct SQL format. 
b. Validate the SOL Statement 


The DBMS validates the statement. It checks the statement against the 


system catalog. The system catalog contains database metadata, including table names, 
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attributes and types. This phase ensures the statement parameters are semantically 
correct. Do all the tables named in the SQL statement exist in the database? Do all of the 
columns exist and are the column names unambiguous? Does the user have the required 


privileges to execute the statement? Certain semantic errors can be detected in this step. 
c. Generate an Access Plan 


The DBMS is responsible for managing the data stored in the database. In 
this phase, based upon the statement, the DBMS generates an access plan. The access 
plan is a binary representation of the steps that are required to execute the statement. The 
DBMS optimizes the access plan. It explores various ways to carry out the access plan. 
Can an index be used to speed a search? Should the DBMS first apply a search condition 
to Table A and then join it to Table B, or should it begin with the join and use the search 
condition afterward? Can a sequential search through a table be avoided or reduced to a 
subset of the table? After exploring the alternatives, the DBMS chooses one of them. 

Optimization is a very CPU-intensive process and requires access to the 
system catalog. For a complex, multi-table query, the optimizer may explore thousands of 
different ways of carrying out the same query. However, the cost of executing the query 
inefficiently is usually so high that the time spent in optimization 1s more than regained in 
increased query execution speed. This is even more significant 1f the same optimized 


access plan can be reused to perform repetitive queries. [Ref. 19] 
d. Execute the Access Plan 


The DBMS will execute the access plan, producing a result set that can be 


passed to the user. 
3. SQL Techniques 


There are various techniques that can employ SQL statements to process a users 
request. This section will briefly present embedded SQL, stored procedures, and call 
level interface. The implementation details of the following are usually specific to each 
DBMS. 


a Embedded SOL 


Embedded SQL allows the use of SQL statements within a host 
language, such as C or C++. The SQL Statement can be static or dynamic. Static SQL is 
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effective 1f the data access can be determined at program design time and is used when 
speed 1s important. 

Each SQL statement starts with an introducer and ends with a terminator, 
which serves as a flag. The code 1s processed by a SQL pre-compiler (provided by the 
DBMS vendor), which separates the source code and the SQL request. The pre-compiler 
substitutes calls to proprietary DBMS routines that provide the run-time link between the 
program and the DBMS. The revised source code is then compiled and ultimately linked 
with the proprietary DBMS library producing the executable. 

The SQL requests that were extracted from the program form a database 
request module, which is processed by a binding utility. This utility examines the SQL 
statements, parses, validates, and optimizes them, and produces an access plan for each 
statement. Because the SQL Statement is hard coded, this processing only needs to occur 
at compiler time, not at run time, resulting in faster run time query execution. 

Dynamic SQL is effective when the data access cannot be determined in 
advance, such as allowing a user to enter a SQL Statement in which the results will be 
displayed in a grid object. The application uses a flag, such as a question markas a place 
holder for parameters that will be supplied latter. The SQL statement with the embedded 
flags is then sent to the DBMS, via a PREPARE (string name) method. This allows the 
DBMS to parse the string, and prepare an access plan. 

When the user enters the input parameters in the client program the 
application will call EXECUTE (string name), passing the DMBS the valid parameters. 
The DBMS can then execute the query and provide the result set back to the user. This 
technique is not as fast as Static Embedded SQL, because of the need to bind the input 


parameters. 
b. Stored Procedures 


Another SQL API is to use stored procedures. A stored procedure is pre- 
compiled SQL code that resides on the database server. Stored procedures take input 
parameters and return a result. A number or procedures can be packaged to form an SQL 
Module which can be stored in the DBMS or linked to the application. A module 
provides logical separation of SQL statements and the programming language/statements. 

Stored procedures are a form of query optimization. They are used for 
efficiency, for SQL statements that are frequently executed and are computationally 
expensive. The database administrator (DBA) creates and stores the procedures in the 
DBMS. Once they are stored, those procedures can be invoked by a client. So instead of 
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submitting a SQL statement, the client will simply invoke the stored procedure the DBA 
has already defined. The database management system can develop, optimize and store 
an access plan for executing the stored procedure, therefore decreasing response time 
when the client invokes the procedure because the access plan will not have to be 
regenerated. Stored procedures can also reduce network congestion, by returning only 
the result set of an operation rather than entire tables that the client may further process. 
The server must be capable of servicing the procedures without limiting 
transaction throughput and ultimately performance. It may be beneficial if a procedure is 
computationally complex and network congestion is light, to have the client, which has 
its own processor, process the request. The server is responsible for serving many 
requests and cannot over commit to one client at the expense of not serving others. 
Triggers are another form of stored procedures. Triggers are special, user 
defined actions in the form of a stored procedure, that are automatically invoked by the 
server based upon data related events. An example of a trigger, might be the automatic 


generation of a parts order if the inventory level of widgets falls below a certain level. 
c. Call Level Interface 


The last SQL technique is to define a Call Level Interface, providing the 
application with a library of DBMS functions that can be called by the application 
program. The database aware application calls CLI functions on the local system, and the 
calls are sent across the network and processed by the DBMS. The initial call may be to 
establish a connection with the remote database. The application builds its SQL 
Statements, places the statement in a buffer then makes a call to send the statement to the 
DBMS for processing. Then the application makes a CLI call to disconnect from the 
DBMS. 

The CLI can be implemented through dynamically linked libraries (DLL). 
Each database vendor is responsible for creating a DLL, also known as a driver to reside 
on the local machine. This allows an application to access information from multiple 
databases simultaneously. By employing a CLI, the DBMS implementation details can 


remain hidden from the application programmer. 
C. DATABASE APPLICATION PROGRAMMING INTERFACES 


There are a number of ways to access a database, unfortunately there 1s no 
standard due to the wide range of vendor specific API's and various network messaging 


protocols employed. The database engines/drivers and various API’s that are employed 
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are usually vendor specific, as each attempts to gain a competitive market advantage by 


extending its SQL API or modifying its version of remote procedure call (RPC). 
1. Proprietary Database Management System Interface 


Each database vendor provides its own version of a database interface in the form 
of a vendor specific APJ. The DBMS usually has a client utilities application which 
encapsulates this API and can communicate back to the database engine. Vendors 
usually support or supply some type of development tool which can be used to create a 
graphical user interface (GUI) frontend to interact with the database backend. Each 
database vendor provides its version of increased efficiency and functionality in an 
attempt to differentiate their relational database management system. In order to take 
advantage of the increased functionality offered, it is usually easier to use their version of 
the database server and GUI tools. 

The benefit of using a proprietary solution is faster transaction processing. This is 
due to the fact that the client uses the database specific language, so no additional 
mapping or translations are required. The disadvantages are that this solution usually 
costs more than other solutions, and greately reduces flexibility, tying the organization to 
a single vendor solution. The organization is limited to only those features available from 
the vendor and may force the user to compromise on functionality. 

Each relational database vendor implements the actual management and 
manipulation of the database and is referred to as a database management system 
(DBMS). To allow a client application to communicate with and access the database, a 
DBMS specific driver or interface must be published. The driver is usually in the form of 
a dynamically linked library (DLL) and resides on the client machine. 

A database aware client graphical user interface (GUI) is created either by using 
DBMS specific tools or a standard programming language. Rapid Application 
Development (RAD) tools such as Delphi, Visual Basic, Visual C++, or Visual Café may 
be used to design the GUI. All client applications must ultimately use the DBMS specific 
driver to interact or communicate with the database engine, which resides on the server. 

The following figure represents how a client would access a remote database. The 
database aware client application will load a database specific driver. The client will use 
Structured Query Language (SQL) interface to communicate with the local DMBS driver. 
Different relational databases provide different types of SQL APIs, or extend existing 
standards to provide market differentiation, so the SQL statement entered by the client 


must be understood by the DBMS specific driver or the driver will be responsible for 
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mapping the SQL statement into a format understandable by the server database engine. 
The driver passes the request down the stack to the DBMS specific transport layer which 
transmits the request to the remote database engine across the network. The database 
transport layer is responsible for establishing and managing the network connection with 
the remote database engine. The DBMS engine then processes the SQL statement and 


returns a result. 


Client 


<A 
DbA ware 


Client 


Application DBMS Specific DBMS Specific 
Driver Engine 


SQL Statement 


Transport Layer Transport Layer 





Figure 1: General Database Access 


Vendors usually provide multiple protocol stacks with the client driver. The 
stacks are responsible for formatting the SQL request into the vendor specific format, and 
transmitting request across the network. The transport layer may implement a vendor 
specific transport protocol or support a common transport interface (TCP/IP or Named 
Pipes). By encapsulating a communication layer, the DBMS driver that resides on the 
client provides the mechanism to communicate with the server over a network. The 
communication layer will implement some form of Remote Procedure Call (RPC) to send 


the SQL statement to the database engine and return the results. 
2. Open Database Connectivity 


"Open Database Connectivity (ODBC) is a specification for a database API. This 
API is independent of any one DBMS or operating system, the ODBC API is language- 
independent but is usually implemented in C or C++. The ODBC API is based on the CLI 
specifications from X/Open and ISO/IEC. ODBC 3.0 fully implements both of these 
specifications and adds features commonly needed by developers of screen-based 
database applications, such as scrollable cursors[Ref. 19]." 

ODBC is designed and controlled by the Microsoft Corporation. It is the current 
Windows standard SQL Application Program Interface (API). Every windows operating 
system installs the ODBC32 administrator in the Windows Control Panel, to register 
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ODBC compliant drivers as they are loaded on the system. A ODBC compliant DBMS 
specific driver that is installed on a system allows a client application to establish a 
database connection and process SQL statements. 

To allow an ODBC enabled application access to a relational database, the 
relational DBMS provides a specific driver in the form of a dynamically linked library 
(DLL) which implements the ODBC API. For example, when a user installs Sybase SQL 
Anywhere on his/her system, a Sybase specific ODBC driver is also installed. Users will 
use the ODBC Administator Utility to configure a data source. An ODBC datasource is a 
name association between a database and the vendor supplied driver. When an ODBC 
enabled application connects to a specific data source, the ODBC driver manager will 
map the data source name to one it maintains in its odbc.ini file. This mapping will yield 
a reference to a vendor supplied driver, which will be dynamically loaded. The driver will 
perform the translation of SQL statements into a vendor specific format, and pass the 
statements down to its implementation of the transport layer, to transmit the request 
across the network to the database engine to be processed. 

The ODBC Driver Manager provides the interface to the DBMS specific driver, 
which implements the ODBC API. The drivers supplied can extend the ODBC API to 
offer additional functionality. | 

The vendor-supplied driver is responsible for connecting and disconnecting from 
the data source, submitting SQL statements to the data source and correctly formatting 
the request in a DBMS specific protocol. To access multiple DBMSs simultaneously, the 
ODBC Drive Manager may load multiple drivers, as required by the application. 

Figure 2 captures the process. Assume a client application is attempting to 
establish a connection to a Sybase database called heteroSADEMO via ODBC. The first 
thing that will happen is the ODBC Drive manager (odbc32.dll) will get loaded. The 
Driver Manager then looks to the system odbcinst.ini file to see if a Sybase driver is 
available. This file holds information about all of the ODBC drivers installed on the 
system. The file will contain the following entry: 


[Sybase SQL Anywhere 5.0] 
Driver=c:\sglany50\win\wod50w.dll 


The driver is available and it contains a reference to the location of the vendor 
specific driver (DLL) which the ODBC Driver Manager will load. It then looks to the 
odbc.ini file to find an ODBC alias that matches the database name the client is 


attempting to establish a connection with. The file contains all ODBC data source names 
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that have been configured on the system, via the ODBC32 administrator utility function. 
In our example the file contains: heteroSADEMO=Sybase SOL Anywhere 5.0 (32 bit) 
where heteroSADEMO is the data source name to the Sybase SQL database. The name 


of the specific database file associated with the aliase is also maintained. 


ODBC ODBC vendor specific Vendor 
Enabled Driver Manager odbc driver Specific Server 
Client (odbc32.dll) (vendor.dll) 
Application 


Odbcinst.ini Translation.dl] Database 





Figure 2: ODBC Implementation [Ref. 26] 


Once the ODBC Drive Manager has confirmed the driver and database exists, it 
will pass all future references to the appropriate vendor specific driver to handle the SQL 
statement. 

The vendor specific driver may use a translation DLL to convert the ASCII 
character set used by a Windows application, to the default character set used by the 
specific database. It is also responsible for communicating with the database engine, and 
passing results back to the ODBC driver, which passes the results to the ODBC client 
application. 

By using ODBC to provide access to a vendor specific database, the application 
can only employ the SQL functions defined by the ODBC standard. As a result, the client 
application may not be able to take advantage of additional functionality that the database 


may be able to provide. 
3. Java Database Connectivity 


The JDBC API is based upon the X/Open SQL Call Level Interface. It is a Java 
database access API. It allows Java client applications the ability to communicate with 


relational databases and 1s a Java based alternative to Microsoft's ODBC API. 
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To provide Java developers immediate access to existing databases, the creators 
of the JDBC API created a Java to ODBC interface called the JDBC-ODBC Bridge. This 
provided immediate relational database access allowing developers to begin exploring the 
API while relational database vendors created proprietary JDBC drivers. This was 
necessary to gain support from the relational database community. As the technology 
matured, additional Java based DBMS specific drivers appeared. Sun categorizes the 


drivers into four types: 


e Type 1: JDBC-ODBC Bridge: short term temporary driver. 

e Type 2. Native API, Partly Java: driver is written in C, maps JDBC calls into 
vendor specific language, passed to the vendor driver and processed 

e Type 3. Network Protocol, All-Java Driver: a middleware solution 

e Type 4. Native Protocol, All-Java Driver: JDBC calls get translated directly 
into a DBMS specific network protocol, example Oracles OCI. 


Chapter III of the thesis 1s devoted to further explanation of the JDBC API. 
4. Middleware 


A middleware server provides access to a number of databases via proprietary 
drivers or the use of other database API's such as ODBC. Transparency is one of the 
primary objectives of distributed computing and middleware database servers satisfy this 
objective. Through the use of a middleware server a client will have no knowledge about 
where the database information is coming from or even what DBMS is being used to 
Store the data. The client will only understand the middleware API and will only be able 
to interact with the middleware object. 

Middleware solutions provides flexibility allowing the client application to use 
one protocol or interface to communicate with the middleware server yet have access to 
many different relational databases. This simplifies the implementation and installation of 
client software. The client only needs to know how to communicate with the middleware 
object , which is handled by the middleware driver. 

The server is responsible for accessing various relational databases. This means 
that the middleware server must contain the database specific drivers, which can 
communicate to specified databases. The overhead associated with providing this broad 
support (access to multiple databases), is possible decreased performance and loss of 


some DBMS functionality enhancements that a vendor proprietary solution may provide. 
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The characteristics of connecting middleware between a client and a server vary 
depending on the types of server (file servers, database servers, web servers, transaction 
servers), platform (software and hardware), and client requirements. According to Orfali 
"Middleware is a vague term that covers all the distributed software needed to support 
interactions between clients and servers. Middleware does not include the software that 
provides the actual service, that 1s in the server's domain. It also does not include the user 
interface or the application's logic —that is in the client's domain." [Ref. 10]. 

Figure 3 depicts a middleware server, that 1s capable of providing access to two 
remote database management systems. In order to provide this functionality, the 
middleware product must know how to communicate with each database, so it will 
contain a database specific driver for each DBMS to which it must connect. The client 
can only interface with the databases via a middleware driver, installed on the client 
machine and must use the middleware API to send requests. 

The important concept here is that the client does not ever need to know how 
many or what types of databases the middleware actually communicates with. All of the 
details are hidden. Databases can be merged, split, added or deleted as long as the 
client/middleware interface remains unchanged. This is a very powerful capability. The 
databases can be remote or local. They can be moved, or upgraded without impacting the 


client application. 
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Figure 3: Middleware Solution 


Middleware can be referred to as a gateway. Gateway is a piece of software that 
causes one DBMS to look like another, accepting the programming interface, SQL 
grammar, and data stream protocol of a single DBMS, and translating it to the 
programming interface, SOL grammar, and data stream protocol of the hidden (target) 
DBMS. Multiple drivers can reside on a gateway, or middleware server. Each database 
requires a proprietary driver to access the database. If multiple clients require access to 


multiple databases, client configuration would be an administrative challenge. By 
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employing a middleware server, all drivers reside on one machine instead of on every 
client machine and can be easily controlled by the system administrator. 

Middleware can be divided into two functional layers, the service specific 
functions, and the underlying utility functions. The service specific functions are the 
services that will be invoked by the client. The utility functions are the communication 
stacks, RPC's, and queuing services that provide the base for the service-specific 


functions. 
5. Common Gateway Interface 


Hyper Text Transfer Protocol (HTTP) 1s a stateless protocol that operates on top 
of TCP/IP. An HTTP client establishes a connection with a web server and issues a 
request. The server returns a response and closes the connection. HTML forms, web 
pages with text fields and a submit button, are common on the internet yet web servers 
are not capable of interpreting their contents. Web servers act as a conduit and pass the 
content of web forms to a back end process that manipulates the form data. 

Common Gateway Interface (CGI) is a protocol, that provides for the 
manipulation of web forms. It allows clients to pass information to server-based 
programs that generate responses in the form of dynamically created web pages. An 
HTTP server listens to incoming connection requests and either returns a file or passes 
the request to a CGI application. The CGI program resides on the HTTP server. Each 
form page has a form tag and a submit button. The submit button will cause the browser 
to gather all user input fields, package them and submit them to the URL specified in the 
action command. The URL contains a host name and the directory and file name of the 
CGI script to invoke. In Figure 4, the user input gets sent to the HTTP server which 
identifies the CGI tag and starts the CGI process, passing it the input information. The 
CGI process, parses the user input, processes it, generates a reponse HTML page (usinge 
HTML tags) and passes the page to the HTTP server that forwards it to the clients web 


browser. 
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Figure 4: Common Gateway Interface 


To handle multiple CGI executions, the HTTP server forks and runs the CGI 
process. CGl is single threaded, meaning servers must create a separate process for each 
request received. One of the primary limitations of CGI is that HTTP is a stateless 
protocol, which means it maintains no knowledge about previous requests. As stated 
earlier, a client will download a form, input the requested data, submit the form to the 
server. The server will fork the CGI process, which will service the request, generated the 
dynamic HTML page, and return it to the client. At this point the transaction is complete. 
In order to service another request, the client must go through the entire cycle once more, 
and the system overhead associated with starting another process. 

Since all CGI processes are executed on the server, limited error checking is 
available on the client side and a lot of overhead is associated with executing the script. 
CGI programs are generally interpreted at run-time and are slower than compiled 
programs. A CGI scipt must exist for each web form that exists. Additionally when Perl 
is choosen as a scripting language, designers must interface a scripted language with the 
databse vendors supplied libraries. Designers must understand the CGI host scripting 
language and must also understand HTML tags to format a result. If executing a database 
aware CGI script, since HTTP is a stateless protocol, the database will have to be opened 
and closed continuously to service the requests, which adds increased overhead and 


decreased response time. 
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D. CLIENT/SERVER MODEL 


Client/server is an overloaded word and can be interpreted a number of ways. 
Some uses of the term represent physical partitioning of applications across computers. 
For example the client computer gets services from a separate file server/computer. 
According to Orfali: "The client/server model, entails two autonomous processes working 
together usually over a network; client processes request specific services which server 
processes respond to and process [Ref. 10]". 

In this thesis we define client/server as two separate logical entities that work 
together over a network to accomplish a task. The server process can reside on the same 
machine as the client, or be located on a physically different machine. A client/server 
implementation is different than a stand alone application. A stand alone application 
does not require the services of another process, it 1s self sufficient. An example of a 
stand alone process would be a basic text editor. As network bandwidth continues to 
increase, the ability to invoke a method on a remote server is becoming transparent to the 
end user, so client/server architectures are becoming more attractive. When designers use 
multi-threading, the benefits of threads making remote method calls may drastically 
improve the performance of an application 

In the client/server architecture it is common for servers to become the clients of 
other server entities. Client/server systems seeks to optimally distribute processing 
activities via many-to-many relationships over different computer platforms. Each server 
process provides a unique set of functions, a client process can interact with many server 
processes. Each server process must be capable of simultaneously handling multiple 
client requests for service. The anticipated benefit of client/server is the ability to 
abstract hardware and software concerns and focus on developing and building user- 
friendly, cost effective systems [Ref. 5]. 

One of the key requirements for a client/server model is the ability for the client 
process and the server process to be able to communicate. Since it is possible for client 
and server processes to be running on separate machines a common network and 
communication protocol must be employed. A client process must be capable of finding 
a server process, via some type of addressing protocol. For example, if TCP/IP is being 
used as the network protocol, the server process may have a thread that is constantly 
listening to a pre-specified port number, say 5000 for client requests. 

Each server has a unique host internet protocol (IP) address for example: 
131.120.1.91. The IP address plus the port number specify a TCP/IP communication 


socket. A client process must know the server socket information to establish a 
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connection with the server. Once connected, the two processes must be capable of 
effectively communicating through those sockets using an agreed upon communication 
protocol, to pass messages back and fourth across a network. 

The communication protocol for distributed client/server computing across a 
network is extremely important. The client and server process must be capable of 
effectively communicating: establishing network connections, passing parameters, and 
various objects across a network in support of the services the server is going to provide. 

All client/server systems have the following distinguishing characteristics [Ref. 
10]: 


e Service: Client/server is primarily a relationship between processes running 
on separate or possibly the same machine. The server process is a provider of 
services. The client is a consumer of services. In essence, client/server 
provides a clean separation of function based on the idea of service. 

e Shared resources: Á server can service many clients at the same time and 
regulate their access to shared resources. 

e Asymmetrical protocols: Clients always initiate the dialog by requesting a 
service. Servers are passively awaiting requests from the clients. 

e Transparency of location: The server is a process that can reside on the same 
machine as the client or on a different machine across a network. As pointed 
out earlier, a program can be a client, a server, or both. 

e Message-based exchanges: Clients and servers are loosely coupled systems 
that interact through a message-passing mechanism. The message is the 
delivery mechanism for the service requests and replies. 

e Encapsulation of services: The server is a specialist”. A message tells a 
server what service is requested; it is then up to the server to determine how to 
get the job done. Servers can be upgraded without affecting the clients as long 
as the published message interface is not changed. 

e Scalability: Client/server systems can be scaled horizontally by adding new 
clients, and vertically by migrating to a larger, faster server machines or multi- 
Servers. 

e Integrity: The server code and server data is centrally maintained, which 
results in cheaper maintenance and the guarding of shared data integrity. At 


the same time, the clients remain personal and independent. 
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1. Two-Tier Client/Server Architecture 


The functional units of the client/server model consist of a client process and a 
server process. An interface 1s declared that specifies what services the server process can 
provide to the client and what the parameters, and return types will be. The services 


could be various methods or functions such as: 


POD OOl ecan setcCommection (String meme... Sumo Pass 
String database); 


ELITE Mector executeQuery (Serrano ques 


In a two-tier environment the server process is capable of providing the service 
and does not require the services of another server. Figure 5 shows a two tier 
client/server model. The client uses the interface to interact with the server process. The 
server process can be running locally or on a remote system. The gray part depicts the 
interface, that declares what methods or services the server process can provide. The 
interface may also handle the communication details to submit a request across a 
network. The black boxes depict business logic. Business logic is a set of rules, that 
enforce or implement an organization's policies. The rules may be located on the server, 


client or both. 
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Figure 5: Two-Tier Client/Server 


One issue that makes the client/server model attractive is that an organization can 
store its business logic on a central server. Business logic is composed of various rules 
that enforce the company's policies. For example, if an organization requires an expense 
report for any expenditures over $20. The logic can be enforced on the server or on the 


client. As with all corporate policies, the rules may change. A new manager decides that 
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$20 1s to low, and that an expense report will only be required for expenditures over 
$100. 

If the logic was enforced in the client application, the organization will have to 
generate a new client application and distribute it throughout the organization. Since 
there are numerous client applications, which may be dispersed throughout the world, 
this can be an expensive endeavor. Also since the business logic can be fairly complex, 
and lengthy, enforcing it in the client will make the client code larger than it otherwise 
could be. So by encapsulating all business logic on the server, organizations can change 
the logic at one location, once again decreasing administrative costs. 

A simple example of a two tier client/server application is MS SQL 6.5 Client 
Configuration Utility. This application is used to configure a client process to 


communicate with a server process. 
2. N- Tier Client Server System 


Since servers can become clients of other servers, ultimately what exists is the 
potential for multiple tiers. Each server provides an interface to the services it can 
provide. Since the implementation details of those services are transparent to the client 
application, the server may use the services of another server process to actually execute 
a method or perform a function. 

The following figure depicts a three tier implementation of a client server model. 
A database aware client is making a database request via a middleware server that uses 


the database management system to actually process the request. 
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Figure 6: N-Tier Client/Server Model 
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Tier one of this system is a client process that can only interface with the 
middleware server. It contains no business logic, so it can be considered a thin client. A 
thin client is a client application that is as small as possible, containing minimal business 
logic. 

The second tier, consists of an application server. The application server 
implements the interface depicted by the dark gray bar. The middleware server, also 
contains the organization's business logic, which is used to enforce policy. In this 
example, the application server, will utilize the interface of the database server. This 
interface may include a database driver, which can process requests into a format 
understandable by the database server (engine), and is responsible for the transport layer, 
or the network protocols to effectively communicate with the database engine. 

The database server, is the third tier in this example. It provides the 
implementation details of the methods made available in its interface, and is once again 
depicted by a dark gray bar. It also is responsible for the implementation of some 
business logic. For example, the DBMS maintains and enforces user access to various 
database operations. This logic is usually defined by the Data Base Administrator. The 
Database Server will service the request and transmit the results back to the application 
server, which may perform some additional manipulation before sending a result back to 
the client. Spreading the functions among multiple tiers provides scalability, faster 
performance, robustness and flexibility. By implementing a middle tier, data can be 


integrated from multiple resources [Ref. 10]. 
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III. JAVA DATABASE CONNECTIVITY (JDBC) 


In this chapter, we provide the details of Java Database Connectivity which is 
implemented in the java.sql package of JDK 1.1. The JDBC API will be covered, 
providing an explanation of key classes, and methods used. For each method a short 
example will be presented. The examples presented represent only a small subset of the 
available methods found in the java.sql package. Consult the JDBC API reference for 
additional information. 

Java Database Connectivity (JDBC) is an application program interface 
developed by Sun Microsystems, that allows a Java program to communicate with a 
database server using Structured Query Language (SQL) commands. It provides Java 
programs the ability to communicate with relational database management systems 
similar to Microsoft’s Open Database Connectivity (ODBC) API [Ref. 13]. The JDBC 
Application Programming Interface is found in the java.sql interface, of JDK 1.1. and 


contains eight interfaces and six classes as can be seen in the following table. 


Interfaces Classes Exceptions 


CallableStatement Date DataTruncation 


Connection DriverManager SQLException 


DatabaseMetaData  DriverPropertyInfo SQLWarning 
Driver Time 

PreparedStatement Timestamp 

ResultSet Types 

ResultSetMetaData 


Statement 





Table 1: JDK1.1 SQL Package 


An explanation of all the classes and interfaces is beyond the scope of this thesis, 
so this chapter will explain and demonstrate the core classes and interfaces which are: 
DriverManager, Connection, PreparedStatement, and ResultSet. Each of the core classes 
corresponds to a critical phase of database access[Ref. 13]. The client cannot continue if 
one of the phases fails by throwing an exception. For example if an appropriate JDBC 


driver cannot be loaded, then a client cannot establish a database connection, because the 


2.7 


Java application will not be able to talk to the backend database engine. If the client 
cannot establish a connection then it cannot create a statement object, which uses the 
connection to transmit a query for processing. 

Figure 7 provides an abstract view at the key interfaces included in the java.sql 
package. The DriverManager, loads the JDBC driver that can communicate with the 
DBMS, for example: the JDBC/ODBC bridge "sun.jdbc.odbc.JdbcOdbcDriver". Once 
the driver 1s properly loaded the Java client application can establish a connection by 
using: driver.getConnection, which returns a connection object. The client then uses the 
connection object to create a statement object. A Statement object moves the SQL string 
to the database engine for preprocessing and eventually execution, which may or may 


not return a result set object. 


: executeQuery 


getConnection preparedStatement 


preparedStatement executeQuery 


PreparedStatement ResultSet 


preparedCall 


CallableStatement 





Figure 7: JDBC Object Relations [Ref. 13] 


Before explaining the interfaces and class methods used in this research the 
following code demonstrates the entire process. A Jdbc:Odbc driver 1s explicitly loaded 
followed by establsihing a connection, submitting a SQL Statement and processing a 


result set. 
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tud 
//set the connection 
Clase rerneane( Sum. Jabc.o0dbc. JdbcOdbcDriver") > 


//connection paramters 


String user = "dba"; 
Serin ePad = "sql"; 
String dbase = "jdbc:odbc:acctsDatabase"; 


//get connection object 
Connection con = DriverManager.getConnection(dbase, 
user, password); 


//get statement object 
Statement stmt = con.createStatement (); 


//execute the SQL statement 
ResultSet result = stmt.execute("select partType from 
Ee.) 


//display the result 


while( result.next() )( 
Spare = result.getSttring("partType"); 
SVoeeteeode.prhintin( "Parte hype: " wart J; 


) 


/lelcse he ceOnpection 
Consclose(); 


A. DRIVERMANAGER CLASS 


The Driver Manager class contains methods that are used to manage a set of JDBC 
drivers. Each JDBC driver must provide a class that implements the Driver interface, 
which is used by the DriverManager. As part of initialization, a program can explicitly 
tell the DriverManager what driver to load, by using the Class.forName(<driver name>) 
call. If the user does not use this call and attempts to create a connection object the 
DriverManager class will check with each registered driver to see if 1t can connect to the 
given URL. If more than one driver can connect to the URL, the DriverManager will 
invoke the first compatible driver encountered. 

Connection objects are generated from the class DriverManager. When 
getConnection is called, the DriverManager will attempt to locate a suitable driver from 


those loaded at initialization and those loaded explicitly using the same classloader as the 
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current applet or application. The URL provided to the getConnection function names the 
driver to be used to establish the connection. The connection protocol supported by Sun 


IS: 


jJdbc:<subprotoco1l>://<host-EsSrtaumber / dacacounce 


For example: String url = "jdbc:dbaw://131.120.1.91:8899/acctsDatabase" uses 
jdbc protocol with a dbaw (dbAnywhere) sub protocol to connect to port 8899, on host 
131.120.1.91, and then presents the data source name acctsDatabase to the port to locate 
the specific database. The DriverManager uses this URL to find a registered Driver 
which can connect to the source. The driver manager is used to establish a connection to 


a datasource. 


public veid setConnectionD 


( 
//explicitly load the driver 
Class.forName("sun.jdbc.odbc.JdbcOdbcDriver"); 


//connection paramters 


String user = "dba"; 
String password = "sql"; 
String dbase - "jdbc:odbc:acctsDatabase"; 


//get connection object 
Connection con = DriverManager.getConnection (dbase, 
user, password); 


"ends et Coniect ion 


B. CONNECTION INTERFACE 


A connection object represents a connection of your application to a database and 
is used to execute the next phase of database access, creating a statement object which 
will allow the user to execute a SQL command. It can also be used to commit a change 
to the database, as well as rollback. 

A transaction is a set of statements that have been executed and committed or 
rolled back. By default all SQL statements are set for automatic commitment, so each 
individual statement is committed to the database upon it's completion. This can be 
disabled by using the method setAutoCommitment(false), which requires the designer to 
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explicitly invoke connection.commit(), to commit the transaction to the database. This is 
effective 1f the user wants to make a number of changes and to commit them all at once. 
To rollback, (remove all the changes since the last commit), invoke 
connection.rollback(). The following section provides an overview of some of the key 


methods that exist in this class. 
1. Statement 


There are three statement objects of which the inheritance hierarchy is: Statement, 
PreparedStatement and CallableStatement. To obtain a statement object the user can call 
connection.createStatement(). The statement object can be used to execute a SQL 
statement. This type of statement object is useful for SQL statements that will only be 


generated once. For example: 


Statement stmt = con.createStatement ( j 
stmt.execute ("CREATE TABLE parts(" + 
"partID SMALLINT NOT NULL, " + 
"partType CHAR(20) NOT NULL) " ); 


, 


Gone omg > 
stmt.close() 


2. PreparedStatement 


To pass in-parameters or to increase efficiency for a SQL statement that will be 
executed a number of times, use a PreparedStatement(). A PreparedStatement takes in- 
parameters which can be passed into a SQL statement after the statement has been 
prepared by the DBMS server. The server formulates and optimizes an access plan, that 
can be re-used multiple times. The access plan is executed when the client uses the 
execute() command. This increases performance, because the DBMS does not need to 
incur the overhead associated with generating an access plan for every statement. Not all 
DBMS's can support this option, in which case the code executes as a statement object. 
For example prepared statements cannot be used with the Text File ODBC Driver. 

To bind input parameters, set X XX is used where XXX can be any primitive type 
or a String. The setX XX methods for setting IN parameter values must specify types that 
are compatible with the defined SQL type of the input parameter. For instance, if the IN 
parameter has SQL type Integer then setInt should be used. Columns can be referenced 


by column index, which begin with one, for greater efficiency, or by column name for 
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convenience. The following example demonstrates how a PreparedStatement can be 


effectively used to populate a table with 100 items, each with a unique partID. 


PEAU LO Commit ere 
con.setAutoCommit (false); 


// insert 100 parts into parts table 

PreparedStatement pstmt = con.prepareStatement ( 
“INSERT INTO parts (parti p aparti D aUan e ML 
(VALUES H S ee oe, 


pstmtosetStraing(l, "are" 
pstmt.setInt(3,.»4)7 


tor (partib = 1; partID <= 100; parement 
potme Seon eA a PartI D) 
pPscmt e pcc (> 

} 


SOn Gomme) = 
pstmt. close (); 


3. Callable statement 


CallableStatement extends PreparedStatement and is used to execute stored 
procedures. Stored procedures are blocks of SQL code that are stored in the database and 
executed on the server. This increases efficiency for SQL Statements that are executed 
often, by reducing the overhead of regenerating an access plan. The DBMS generates 
and stores the access plan once, and other applications can use the procedure. Stored 
procedures need to be supported by the database, and the exact syntax may differ 
between vendors. 

JDBC provides a stored procedure SQL escape that allows stored procedures to be 
called in a standard way for all RDBMS's. This escape syntax has one form that includes 
a result parameter and one that does not. If used, the result parameter must be registered 
as an OUT parameter. The other parameters may be used for input, output or both. 
Parameters are refered to sequentially, by number. The first parameter is 1. The 
following example of creating a stored procedure is from JavaSofts Java DataBase 


Programming Tutorial [Ref. 27]. 


oy 


Sime execute NCREATESRROCEBUREwgetDailyTotal " + 
MO 220),  GdWTotalMint Output “+ 
"AS " + 
BEGIN + 
à SELECT @dayTotal = sum (cups) " + 
E FROM coffeeData " + 
E WHERE day = @day " + 
"ENDE > 


If the designer knows there are no output parameters, but input parameters are 
required use PreparedStatement. If there are no input and output parameters Statement 


can be used. Once the stored procedure is created, it maybe executed with the following: 


CallableStatement cstmt = con.prepareCall("{call 
ge Dailyrotal (?; ?) }"); 
estmts eto ima (1 "Moni 
cstmt.registerO0utParameter(2, java.sql.Types. INTEGER) ;. 
cstmt.executeUpdate(); 
Syatremsciteapeintin( "Totalefor Mon is " + 
SSEueMEenger rma (2) =) 


IN parameter values are set using the set methods inherited from 
PreparedStatement. So in this case an in parameter is "Mon". The type of all OUT 
parameters must be registered prior to executing the stored procedure so 
registerOutParameter(2, java.sql. Types. INTEGER), then execute the statement. The get 
method must be used to retrieve the OUT parameters. Columns are referenced by index 
for efficiency in this example. A Callable statement may return a ResultSet or multiple 
ResultSets. 


4. DatabaseMetaData 


Another key method provided by the connection class is getMetaData(), which 
returns a DatabaseMetaData object. Metadata is data about the database and its contents 
can be discovered at run time. Each database maintains a dynamic catalog that describes 


itself to include the tables, views, privileges and capabilities of the database. This object 
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is able to provide information describing the database tables, its supported SQL grammar, 
its stored procedures, and the capabilities of this connection. The DatabaseMetaData 
interface has a total of 133 methods [Ref. 10]. For example, to get the names of all the 


tables in a database the following method could be used: 


getTables (String catalog, 
String schemaPattern, 
String tableNamePattern, 
String types[]) throws SQLException 


A schema describes a group of related tables and access permissions. A catalog 
describes a group of related schemas. There are a number of types to include "TABLE" 


and "VIEW". To use the method to provide a list of available tables from a database: 


DatabaseMetaData dmd = con.getMetaData(); 
Stringi] cypss = {[ "TABLE" }; 
ResultSet rs = dmd.getTables (null, null, "3", types) 


The ResultSet contains information about all tables in the database, for example 
to get the table name, which is contained in the third argument, use String name = 
rs.getString(3). This information is important for code portability. To populate a drop 


down menu, this information can provide the table choices dynamically. 
C. STATEMENT INTERFACE 


A statement object 1s a container for executing SQL statements. This represents 
the next phase of database access, the execution of a SQL statement. One statement 
object can be reused many times to execute a number of SQL Statements. There are 
three functions that can be invoked to execute the SQL statement depending upon the 
type of SQL operation. 


1. Execute 


The method boolean execute(String sql) is used to execute dynamic SQL 
statement when the designer does not know 1f the statement will be an update, or query 
operation. The method returns true ifa ResultSet was generated via a query. This 


indicates to the designer that the operation was a select, now the calling method may 
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process the result set. If the method returns false, this indicates that the statement was an 
update, and returns the number of rows affected by the statement. In both cases the 


results can be obtained as follows: 


ResultSet result = statement.getResultSet() 
int rowsUpdated = stmt.getUpdateCount (). 


When the designer knows what type of SQL Statement is being executed it is 


more appropriate to use executeQuery or executeUpdate. 
2. Execute Query 


The method resultSet executeQuery(String sql) should be used when the client is 
executing a SELECT SQL Statement and is prepared to process a ResultSet. Select 
statements are used to extract data from various tables based upon search criteria. The 
ResultSet object returned is never null. The rows in the result are accessed in order, but 
the elements in the various columns can be accessed in an order. It is recommended that 


columns be accessed from left to right and that each row be read only once. 


ResultSet result = stmt.executeQuery ("SELECT * FROM 


Partsi) 
3. Execute Update 


The method int executeUpdate(String sql) is used to execute a SQL INSERT, 
UPDATE or DELETE statement. It returns a row count representing the number of rows 
affected by the SQL statement or zero for SQL statements that return nothing. The 
following code demonstrates the various update functions (Create, Insert, Update, 
Delete). For each of the following examples assume that "stmt" is a valid Statement 


object. 
a. Create Table 


A two dimensional table is used to abstractly view tables. Each table has a 
table name and has various attributes of various types which represent the column 
headers. The following example depicts the SQL string for creating a table called 


invoices, that contains two attributes: id and supplier. 
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stmt.executeUpdate("CREATE TABLE invoices( id int, 
supplier chan w) ) "S 


b. Insert 


Inserts data into a pre-existing table. User must specify the table name, 


the column names, and the corresponding values to be inserted into the table. 


stmt.executeUpdate("INSERT INTO invoices (id, 
supplier) VALUES (2055 POr I 


c. Update 


This SQL command is used to update a specific field of a table. 


MEE Ur CUpOaRe F UPDATE parts SET anty =.„5 
WHERE part = 'brake pad' "); 


d. Delete 


This command removes one or more rows, or tuples from the specified 
table. The following example would delete all tuples where part is muffler from the parts 
table. 

stmt.executeUpdate ("DELETE FROM parts WHERE part = 


Bue t lew 
D. RESULTSET INTERFACE 


A ResultSet object captures the information returned from a SELECT Statement. 
The object maintains a cursor that points to the current row of data, which can be 
traversed via the next() method. This object provides methods that allow access to the 
results of a query. A ResultSet is automatically closed by the Statement that generated it 
when that Statement is closed, re-executed, or is used to retrieve the next result from a 


sequence of multiple results. 
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1. Get Meta Data 


The ResultSetMetaData getMetaData() method retums a ResultSetMetaData 
object which can provide detailed information about the ResultSet, to include column 
information. This information is useful in presenting the ResultSet in an interface. The 
following lists only a few of the ResultSetMetaData methods, see Interface 
java.sql.ResultSetMetaData API for additional methods. 


ResultSetMetaData rsmd = rs.getMetaData(); 

Ine Column ount = rsmd.getColumnCount (); 

ings columnWidth = rsmd.getColumnDisplayszze(ix); 
String columnName = rsmd.getColumnName (ix); 


int javaSQLType = rsmd. getColumnType (ix) 


2. Get Type 


The XXX getXXX method is used to get results from a ResultSet. If getString is 
used, then it will return a String. So based upon the column index, it will convert the 
type into the Java specified type by the getX XX. Not all conversions are legal so the 
correct conversion should be used. The method is overloaded to also accept a String, the 
column name, as an in parameter. Column names used as input to getX X X methods are 


case insensitive. 
3. Next 


There is a "row cursor" in the result that points to the current row. The method 
result.next(), moves the cursor to the next row, and returns true if the row exists. The 
ResultSet object controls access to the row results of a given statement. The method must 
be called to initialize the cursor to point to the first row of data. For example to step 
through a ResultSet result, the next() method would be used as follows: 


SELLING Park; 

intr gquâant ity; 

while(result.next() ){ 
part = result.getString("part"); 
quantity - result.getInt("gnty"); 
SECO ME printilon pare EE dE 
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The application designer needs to know what data type 1s included in the result set, 
and the name of the column to access the results. Once again, the designer can reference 
the column containing the data by name or by index. To get the results a data conversion 
from the SQL return type to the desired Java data type 1s required. The getX XX method 
must be used to get various SQL data types. 

For each getX XX method, the JDBC driver must convert between the database 
type and a Java equivalent. An invalid data conversion will result in an exception. Some 
SQL types have a direct Java equivalent, such as SQL Integer to a Java int. Several SQL 
types can be converted to a Java equivalent, such as SQL char, varchar, and longvarchar 


to Java string type. 
E. JDBC DRIVERS 


Database drivers provide the implementation of the abstract classes provided by 
the JDBC API. The driver resides on the Java client machine and is used to establish a 
connection to a relational database. The JDBC driver can be a JDBC/ODBC bridge, a 
middleware protocol library, or a native database driver. The driver provides the "black 
box" interface, that accepts JDBC input from the Java application, and understands the 
vendor specific relational database language and network protocols. It accepts the JDBC 
input from the client application, translates it to a vendor specific protocol, and uses a 
vendor supporting networking protocol to transmit the request across the network. 

In order to pass the JDBC compliance tests, drivers are required to support at least 
ANSI SQL 92 Entry Level (SQL2). There are four categories of JDBC drivers as 
designated by JavaSoft.[Ref. 12] The drivers are: 


e Typel  JDBC/ODBC bridge: Available with JDK 1.1, uses existing ODBC 
vendor drivers. The slowest driver to translating JDBC calls to ODBC calls to 
vendor specific calls. 

e Type II. Native-API, partly Java driver: Translates JDBC call into language 
understood by the specific DMBS client driver, then invokes the client driver for 
further processing. Faster than Type I, slower than Type IV. Can only interface 
with specific DBMS. 
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e Type III. Network-protocol, all-Java driver: Provides flexibility, may use 
ODBC/JDBC bridge or native protocol drivers to access DBMS's. Not as fast as 
Type If or IV drivers. Simplifies administration, all DBMS specific drivers are 
loaded on the middleware server machine. Clients only requires the network 


protocol interface and middleware API to communicate with the TYPE III driver. 


e Type IV. Native-protocol, all-Java driver: Provides the fastest access, mapping 
the JDBC calls directly into a DMBS protocol. Can only interface with vendor 
specific DBMS and can be expensive. Requires each client machine to have a 


driver, so increases administrative burden of managing licenses. 
1. JDBC/ODBC Bridge (Type I) 


The JDBC/ODBC Bridge (Figure 8) was designed to take advantage of the large 
number of ODBC enabled drivers. The bridge was intended to provide an initial solution 
until database vendors could produce their own vendor specific JDBC drivers. Basically 
the bridge converts the JDBC calls into ODBC calls. The ODBC driver manager, will 
invoke the database vendor specific ODBC driver, and pass the calls to database driver 
for further processing. 

The client side application or applet uses the JDBC API to load the 
"sun.jdbc.odbc.JdbcOdbcDriver". This driver translates the Java SQL statements into 
and ODBC format, then invokes the ODBC Driver Manager (odbc32.dll) which refers to 
the odbc.ini file that contains a data source name and vendor specific driver it is 
associated with. The vendor specific driver or dll then translates the ODBC call into a 
vendor specific call, and sends the request across the network to the database manager. 
The process is reversed when a response is sent from the database manager back to the 


client application. 
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Figure 8: JOBC/ODBC Bridge 


One of the disadvantages of using the JDBC/ODBC Bridge is the overhead 
associated with the call mappings. Java applications can be written using the JDBC API 
but all calls must be filtered through the bridge and translated into ODBC calls that are 
understood by the respective relational databases. The call must go from JDBC through 
the bridge to the ODBC driver and finally from ODBC to the native client-API, say 
Sybase SQL Anywhere in this example, then to the database. 

A JDBC/ODBC bridge is effective for an application server. A middleware 
server provides the database access, so all ODBC drivers reside on that machine. The 
client makes a call to the application server, which establishes the database connection 
and returns a string or data stream to the client. The application server used the JDBC 
API to interact with the database. The client does not use the JDBC API at all. This was 
the implementation used in our socket and remote method invocation models that follow 


in Chapters IV, and V respectively. 
2. Native-API, Partly Java Driver (Type II) 


Type II drivers convert Java calls into vendor specific calls. The drivers are 
usually written in C, accept the Java calls then map them to vendor specific calls. The 
call then gets processed by the vendor specific driver, translating it into the DBMS's 
specific query language and communication protocol. This is a partly Java driver, that 
requires a vendor supplied library to translate JDBC functions into the DBMS's specific 
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query language, such as Oracle’s OCI [Ref.23]. Type II Drivers bypass the ODBC 


translation, so are faster than Type I drivers. 
These drivers usually cost more than other drivers and reduce flexibility. The 


performance increase may warrant employing native drivers, if the organization is 


committed to a single DBMS. 
3. Network Protocol, All-Java Driver (Type III) 


The network Type III driver (Figure 9) translates JDBC calls into a database 
independent network protocol, and passes this request to a middle tier server which then 
translates the request into a DBMS specific protocol. Type III drivers are attractive for 
Internet/Intranet based multi-user data intensive applications (requiring access to multiple 
databases). A Type III driver can be written in Java. The cost associated with writing the 
driver in Java is decreased performance time since Java is slower than compiled 
languages like C/C++. The advantage of being written in Java is that the server can use 
any JDBC driver to connect to the target database(s). In Chapter VI, we use a type III 


Middleware driver to connect our Java client application to various relational databses. 
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Figure 9: Net Protocol All Java Driver 


To communicate with the Type 3 server a client class file must be installed on the 


client machine. This class file can be downloaded with the applet or application. For 
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example, when dbAnywhere is used as the middleware server, the client needs to have 
the dbaw.zip archive to communicate with the dbAnywhere Server. The Database Server 
manages the transfer of information and calls between the Client and the DBMS. The 
bridge transforms Java calls to DBMS protocol and the DBMS responses back into Java. 

The Type III driver contains a number of vendor specific drivers, or can use the 
ODBC/JDBC driver to provide database access. The bridge can connect the client to 
local databases, which must reside on the same machine as the middleware server, such 
as MS Access, or to remote databases such as Oracle, MS SQL Server, SyBase, 
InterBase, or IBM DB/2, stored on another machine. 

As can be expected, a Type III driver is slower than other JDBC drivers. In an 
evaluation by Mukal Sood [Ref. 23], the average connection time for a Type IV driver 
was approximately 1.1seconds, and the fastest for a type III driver was 8.4 seconds. The 
benefit of using a Type III driver is flexibility, installation, and database administrator 
maintenance. Type III drivers, can encapsulate Type IV drivers. For example, 


dbAnywhere provides proprietary database access for Oracle 7.x. 
4. Native-Protocol, All-Java Driver (Type IV) 


Type IV JDBC drivers convert the JDBC calls directly into the network protocol 
used by the specific DBMS. These drivers can be written entirely in Java, and can 
provide just in time delivery of applets. Type IV drivers provide for the best database 
access because of the direct translation, unfortunately they can only be supplied by the 
vendor and can only interface with the vendor specific database. For example, Sybase 
jConnect is a Type IV JDBC driver written entirely in Java and communicates directly to 
Sybase data sources such as Sybase SQL Anywhere. It uses Sybase's Tabular Data 


Stream (TDS) as the communication protocol between Sybase clients and servers. 
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The advantage of a Type IV driver is increased performance. The number of 
translations is reduced to one, which directly translates the call into a DBMS specific call. 
The disadvantage of such a solution is the driver is supplied by the vendor and is 


proprietary and therefore comes with a higher cost. 
5. Driver Selection 


The selection of which type of driver to employ depends upon a number of 
factors: number of databases requiring access, performance requirements, financial, and 


system administration requirements. 
F. CONCLUSION 


Java Data Base Connectivity is a competing standard for database access. Ït 
provides the interface for application designers to be able access a database and is easy to 
understand, implement and use. Throughout the rest of this thesis JDBC will be used in 
various client-server configurations to provide heterogeneous database access. 

In order to fully demonstrate the potential for Java database access in the 
commercial environment, the networking abilities of the language need to be explored. 
The next chapter will look at socket programming to provide the communication link 
between the client and the database aware server, and Chapter V will use Java's Remote 
Method Invocation to provide the communication link. For both these implementations 
the JDBC-ODBC bridge will be used as the driver and we will use the java.sql package to 
provide the database manipulation and access. In Chapter VI, two type III JDBC drivers 
will be used: Borland's DataGateway and Symantec's dbAnywhere. Their respective 
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database development integrated development environment tools will be used to facilitate 
database access. 
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IV. SOCKETS AND JDBC 


A. INTRODUCTION 


Connecting to a database and receiving information from it requires a lot of 
underlying communication. The client and server application have an established 
communication protocol, to effectively communicate and handle requests and responses. 
As pointed out earlier in a client/server environment, this communication may take place 
in a two-tier architecture (client database application talks directly to the database server 
over a network) or in a three-tier architecture (client application talks to the database 
server via a middleware server). Regardless of these architectures, the underlying 
communication between client and server side can be handled in a variety of ways. 

Java provides an effective communications API to assist developers in 
developing distributed applications. Java offers socket-based communications that enable 
applications to handle network communications as if it were file I/O. 

Communicating through sockets involves low-level programming. Associated 
with this requirement is the added flexibility of implementing a solution that meets a 
specific need. The next level of abstraction is Java Remote Method Invocation (RMI), 
which encapsulates low level socket programming, allowing local objects to 
communciate with remote objects via standard method invocations. 

In this chapter, we provide an overview of Java socket programming, followed by 
a multi-cast distributed socket database model. We will evaluate the database 


connectivity issues using RMI in Chapter V. 
B. SOCKETS 


A socket encapsulates the information about both the host computer identification 
and the port number on which the socket is created and acts as a conduit between 
processes. Sockets are the software abstraction of the address space of an Internet host 
and one of its ports. An internet address is a unique 32-bit (IPv6 is 128-bit) number for a 
host. A TCP/IP host can may have as many internet addresses as it has network 
interfaces. A port is an entry point to an application that resides on a host and it is 
represented by a 16-bit integer. When a socket is created, the process that owns it can 
communicate with another process by going through that socket and a corresponding 


socket on the other side. 


45 


À socket is either a stream socket or a datagram socket. Stream sockets interface 
to Transfer Control Protocol (TCP) and are connection-oriented where datagram sockets 
interface to User Datagram Protocol (UDP) and are connection-less. 

In connection-oriented communication, a connection between processes is 
established before data can be exchanged. Establishing the connection involves creating 
sockets, sending a connection request and accepting the request. This may take place as a 
two-way (request, reply) or three-way (request, request-reply, reply) handshake. Once the 
connection is established and while 1t is in place, data flows between processes through 
the sockets as streams of bytes. 

The datagram sockets handle connectionless communication. There is no need to 
establish a connection in order to send a message for connectionless socket-based 
communication. Data sent between processes is called a packet and contains the 
destination IP address, destination port and data. Datagram socket communication is 
fast, but unreliable. As Stallings pointed out “In the datagram approach, each packet is 
treated independently, with no reference to packets that have gone before” [Ref. 24]. As 
local area networks become more reliable through the use of fiber, datagram socket 
communication is attractive due to increased performance over TCP sockets. 

In order to implement socket-based communication, Java provides a socket API 
contained in the java.net package. This package allows programmers to do both low- 
level networking with DatagramPacket objects which use datagram sockets, and 
connection-oriented networking with ServerSocket and socket objects which implement 
stream sockets. 

Java also provides for multicast socket communication. Multicast socket 
communication is a communication method which is implemented using datagram 
sockets to send UDP packets to a group of processes that may be servers or clients. The 
java.net package contains a MulticastSocket class which lets programmers implement 
multicast communication. 

Regardless of what type of socket communication takes place, the client and the 
server programs must agree upon the communication protocol that is to be used. The 
protocol must include what port numbers to send data to, what message format to use. 
The client or recipient of the datagram packet must parse the data and determine what 
action to take. So for example, the protocol may establishes that a "|", will separate 
tokens, and if the first token it the word "net", then the client knows it is a network 
request and can invoke the appropriate handler. Regardless of what type of information is 
contained in the message, both server and client side applications must invoke 


appropriate methods to process the data. Figure 11 depicts a general socket-based 
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client/server communication diagram. The client machine is located at IP address 
131.120.1.91 and is using port number 6500 to communcate with a server object located 
at 131.120.1.226, listening to port 7500. The server object may then access a database 
via a JDBC driver to service the clients request. We are going to modify this diagram 


later on based on the type of sockets being used between client and server: 


Client 


JDBC 
Driver 


131.120.1.91:6500 >* 131.120.1.226:7500 





Figure 11: Socket Communications 


1. Stream Socket Communication 


A server may have more than one client, so it should have a dedicated listening 
socket for clients that wish to create a session. This socket cannot be blocked so, a 
communication channel is established for each client. The server socket is the first socket 
that receives the clients’ initial connection request message and assigns the actual 
communication socket by accepting the request, depending on how many connections it 


can handle in total. This type of communication involves the following steps: 


e Create a server socket whose sole purpose is to wait for connection requests 
from clients (by using an infinite “while” or “for” loop) 
int port — 5000; //port number that the server will be listening on (this port 
//should not be used simultaneously by any other processes in the system) 


ServerSocket ss = new ServerSocket(port); 


e Clients make connection requests to the server socket by creating a stream 
socket to server's IP address and port number 
int serverPort = 5000; //client must know server's port number 
//convert string representation of server’s IP address to InetAddress object 
InetAddress host = InetAddress. getByName(“131.120.1.91”"); 


//make the connection request 
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Socket clientSideSocket = new Socket(host, port); //stream socket 


e Server accepts the request (blocking until a request comes) and assigns a new 
stream socket to be used for additional communication 
Socket serverSideSocket = ss.accept(); //wait for a client to connect and 


//generate a stream socket to communicate with the calling client 


e Data communication (stream of data) 
An Output stream object is used to send the stream of bytes (data) and an 
input stream object for receiving the data. If both the client and the server 
want to send and receive the data, then they must create their output and input 


stream object pairs. 


e Closing the connection 
serverSideSocket.close(); //server process code 


clientSideSocket.close(); //client process code 


Figure 12 depicts the general idea behind having one server socket which then 
assigns sockets for clients to continue to communicate with the server. The important 
thing in this communication cycle is that the ServerSocket ss is not used for the actual 
communication between the server and its client. It is only used to establish a connection 
to a client by assigning a new stream socket for follow-up communication. In order to 
setup a connection to any number of clients, the same ServerSocket may be used 
repeatedly. 

After a communication channel has been established between the client and the 
server, each needs to create its own input and output stream objects in order to pass 
messages back and forth. A sample implementation can be seen in Appendix B which 
demonstrates how ServerSocket and Socket classes can be used to serve clients for 
database access and data manipulation requests. The client in this implementation sends 
queries as stream of bytes through its output stream object. The server receives requests 
via input stream object and handles it by calling our ExecuteSQL function. The 
executeQuery method executes the query by invoking the appropriate JDBC API 
methods. The server places the results into a vector of hash tables which can be easily 
converted into stream of bytes to be sent to the client via the server's output stream 


socket. When the client receives the data from its input stream, it just prints 1t to the 
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screen without worrying about its format, because the stream has been pre-formatted by 


the server (1.e., each line contains one tuple). 


Client 1 
Socket (data) 


Client 2 
Socket (data) 





Driver _ DB | 


Socket (data) 
«———-» Connection request 


© Socket (data) 


4 > Follow-up | 
communication 





Figure 12: Stream Socket Communication 


2. Datagram Socket Communication 


Datagram socket communication is based on User Datagram Protocol (UDP) 
which is a packet-switching protocol and uses unreliable datagram packets. UDP does not 
attempt to ensure that each packet reaches its destination. According to David Flanagan, 
“A datagram is a very low-level networking interface: it 1s simply an array of bytes sent 
over the network. A datagram does not implement any kind of stream-based 
communication protocol, and there 1s no connection established between the sender and 
the receiver. Datagram packets are called *unreliable' because the protocol does not make 
any attempt to ensure that they arrived or to resend them if they did not. Thus, packets 
sent through a datagram socket are not guaranteed to arrive in the order sent, or to arrive 
at all. On the other hand, this low-overhead protocol makes datagram transmission very 
fast "[Ref. 24]. 

The java.net package has a DatagramSocket class to implement datagram 


transmission. Datagram sockets are created by specifying a port number. If left 
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unspecified, the operating system will assign a port number automatically. The java.net 
package also offers a DatagramPacket class which programmers can use to create 
datagram packets that contain data, a destination address and a destination port. The 


following is an example of how to create and send a datagram packet: 


//create a byte array that will contain the data 
int dataLength = 100; 
byte[] dataArray = new byte[dataLength]; 


String host = "230.0.1.222", //destinationsadduess 
int port = 4446; //destination port number 
//get the Internet address of desired host 
InetAddress address = InetAddress.getByName (host) ; 


//create a datagram packet 
datagramPacket packet = new DatagramPacket (dataArray, 
dataLength, address, port); 


//create a datagram socket in order to send the packet 


DatagramSocket datagramSocket = new DatagramSocket (); 


//send the packet 
cala ans oasis. Senda (Paciet 


//close the socket 
datagramSocket.close(); 


The following is an example of how to receive a datagram packet: 


//create a datagram socket to listen on a desired port 
int port = 4446; 
DatagramSocket datagramSocket = new 


DatagramSocket (port) ; 


// create a buffer (a byte array) to read datagrams 


//into. If the incoming packet 
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Int Mamburrer = 1024; 


byte[] buffer = new Byte[maxBuffer] ; 


//create an empty buffered datagram packet 
DatagramPacket packet = new DatagramPacket (buffer, 


maxBuffer); 


//wait to receive a datagram (blocking) 


datagramSocket. receive (packet) ; 


Section C of this chapter provides a more detailed example of the use of datagram 
sockets. The model also demonstrates the power of multicast sockets which will be 


explained next. 
3. Multicast Socket Communication 


The exchange of single messages is not the best model for communication from 
one client to a group of servers which provide either common or different sets of services. 
This raises the issue of group communication which can be implemented using Java's 
MulticastSocket class. Multicasting means sending a single message to a group of 
processes. Multicast messages may be multicast UDP packets or stream objects. 

The Java MulticastSocket class offers joinGroup() and leaveGroup() methods for 
group management. À process can be a member of multiple groups. Each group must 
have a valid IP address in the range of 224.0.0.1 to 239.255.255.255. In order to receive a 
multicast message a process must be a member of a group, but it is not necessary to be a 
member of a group in order to send a multicast message to a group. 

In a client/server environment, server processes may be clients of other server 
processes. If the members of a multicast group are database servers, then coordination 
and control facilities between different databases can be implemented in an efficient way. 
The model explained in the following section demonstrates how multicast socket 
communication is used effectively between the companies of an Army Battalion. Each of 


which is maintaining a repair parts database. 
C. MULTICAST SOCKET JDBC MODEL 


This model has been created to demonstrate Java Database Connectivity using 


both unreliable, yet fast datagram sockets for point-to-point communication between 
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client and server applications and multicast sockets for handling coordination and control 
facilities between a group of database servers and client applications. lt has been 
implemented using the Java Programming Language and the source code can be found in 
Appendix B. The actual evaluation environment is shown in the following figure. The 
objects a CoParts, b CoParts and c CoParts act as database servers whose only 
privileges are querying (select only) and updating their own databases. The a CoParts 
and b CoParts servers and their databases (Microsoft Access Database) reside on a 
machine named "roxanne". The c CoParts server resides on a machine called "fido", but 
Its database (Microsoft SQL 6.5 Database) resides on a remote machine named 
"cryptologist" which 1s running Microsoft SQL 6.5 Server. The 1 BnParts object is a 
high-privileged database server which can manipulate all three of the databases. 


] BnParts resides on machine "roxanne". 


roxanne 
131.120.1.91 


fido cryptologist 
131.120.1.57 131.120.1.226 





Figure 13: Socket Evaluation Environment 


In our model each database server has a different method of handling client 
requests based on what level of authority it has. For example some database servers have 
search only capabilities and these can only return the result sets of database queries. 
Other database servers may have the capability of updating the database and others may 


have more detailed database management capabilities. You can picture this as a chain of 
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command with each individual level in the chain having different responsibilities and 
based on those responsibilities having different functionality. 

Database servers may form a multicast group that handles client requests. Clients 
can ask database servers to join or leave a particular multicast group by sending “join” or 
“leave” messages. Clients can also communicate directly with database servers through 
datagram sockets. 

The most significant advantage this model is giving clients access to 
heterogeneous databases in a heterogeneous environment. By doing so, each client can 
easily find what it is looking for by sending a multicast request to the group. So for 
example, 1f a company was looking for a certain part, it would check it's local database. 
If the part did not exist, 1t would send a multicast request to the group to find if another 
company has the required part. If no company has the required part, the request gets 
forwarded to the Battalion object which will attempt to find the part or ultimately order it. 


1. Communication Protocol 


This model allows client applications to access multiple databases and manipulate 
(query, update, insert etc.) them by multicasting or communicating with them directly in | 
a point-to-point manner. So each database object has a privite listening port, used for 
point-point communication and a multicast port used for group communication. 

For this model we created a communications protocol that client applications 
must use in order to establish communication with servers. This communications protocol 
is a message format that must be followed in order to send a multicast or a point-to-point 
message to any database server. 

A message contains three parts as seen in Figure 14. The first two parts constitute 


the message header. And the third part contains the actual message. 


Message type 


eS 


Message Header Message Body 





Figure 14: Message Format 
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A detailed explanation of the communication protocol used in the socket 
implementation will highlight the level of detail required to effectively communicate 
between two processes. Figure 15 depicts the simple communication protocol used in the 
model. To implement the details, various logic modules were created to include db, net, 
and respond modules. Each logic module is an object that can provide a requested 
service. The first token of the message (db, net, response) indicated which logic module 
to instantiate to service the message. So as the message is received by a server, it parses 
the message. Based upon the first token, a logic module is instantiated and the remainder 
of the message 1s passed to the logic module. 

Since a message can be directed to an individual server, or group of servers, the 
message recipient looks at the next token. The second token 1s used to differentiate a 
request for a specific server from a request for a group of servers. If the message is a 
multicast message, then the "all" key word is used, otherwise the second token must be 
the name of the database server to make a point-to-point communication. The following 
examples demonstrate the protocol: 

"db all <request>” is an example of a database related multicast message. 

“net a CoParts «request^" is an example of a communication related point-to- 
point message. The recipient of this message is the Alfa Company (a CoParts) database 
server. 

"response db «request» * 1s an example of a response message to the client after a 
database query. So the client knows 1t has received a result set that needs to be displayed. 

By parsing the message and implementing various logic modules, functionality 
could be added to the objects. For example all database objects (a_CoParts, b_CoParts, 
and c_CoParts) used the same class files. So the application code was reused by multiple 
objects. When an instance was created, the constructor accepted a name, such as 
"a CoParts" which would be used to differentiate the object. This was effective in 
handling general networking logic, and client display logic, but was not effective for the 
database logic module. 

So each database ojbect, would have it's own specific database logic module. 
This module would be used to set a connection to the database, and manipulate the 
database. Ifa company was given more database manipulation capabilities, such as being 


authorized to order parts, then it would be given the appropriate database logic module. 
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all <sql statement> 


<name of the server> <sql statement> 


<name of the server> join 


«name of the server» leave 


«name of the server» respond 


response «message» 


«message^ 


«message» 





Figure 15: Message Format 


The message body of a database related messages must be SQL 


statements specific to the databases maintained by database servers. For example: 
* db all SELECT part FROM PartsTable WHERE part = ‘tire-5443’ ” 


could be a multicast message looking for a specific tire from a database server group. 
Any database server that finds the tire in its database responds to the client. If the server 
does not have the part, a negative acknowledgement is sent. 

The body of multicast communication related messages should be either a “join” 
or a “leave” key word. A “join” message 1s a request to a database server to enter a 
multicast group and remain a part of that group until a “leave” message 1s sent. For 
example, “net aCoParts join ” instructs the Alfa Company database server to join the 
multicast group. The network logic module implemented by "a CoParts" would start a 


java thread. The thread would be a group multicast listening thread, that would listen to 
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multicast communications, and spawn a message handler thread in response to any group 
messages received. 

A Java StringTokenizer object is used to parse these messages with a delimiter of 
white space. Tokens are evaluated by middleware servers and an appropriate logic 
module is called to handle the requests. The following section explains how these 
messages are sent between processes and how multicast and datagram sockets are used 


effectively in this environment. 
2. Model Implementation 


To effectively communicate an established protocol must be followed by the 
sending and receiving processes. The figure 16 depicts a client/server socket model used 
to make database requests. The client sends a datagram packet containing the following 


message: 
doron C TEGEI Lire fromeparts Where partid = 5255 


The database middleware server receives the datagram packet and spawns a 
messageHandlerThread to service the request. The messageHandlerThread parses the 
message into tokens. If the first token is db, the handler knows it is a database request 
and will instantiate a database object to further process the message. The database object 
extracts the next token, which specifies the database that is to process the SQL request. 
In this case the second token is a CoParts, so the server knows the request is specifically 
for A Company, and generates an a. CoPartsLogic object. 

The third token is the actual SOL statement to be processed by a CoParts. The 
database logic object uses the JDBC API to communicate with the remote or local 
database management system. In our model the JOBC-ODBC bridge is used to translate 
the Java calls into ODBC calls, which invoke the database specific ODBC driver. The 
request is then translated from ODBC to a vendor specific protocol and sent across the 
network to the DBMS Driver manager. The driver manager executes the SQL statement 
and returns a result set, 1f applicable. 

If a result set is generated, it is the responsibility of the a CoPartsLogic object to 
create a socket and datagram packet, and send the results to the client process. The result 
set must be packaged using the agreed upon delimators so the client can parse and utilize 


the response. 
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The client process follows the same communication protocol as the database 
server, and generates a messageHandlerThread to process the message. The 
messageHandlerThread removes the first token, which identifies the message as a net 
logic response. The net logic further processes the request and realizes it is database 


response whose result set is then displayed on the screen. 


Database 
Middleware 
Server 


rdquestThreadHandler 


Vendor ODBC DLL 
DBMS Drive Manager 


Middleware Server remote /local DBMS 





Figure 16: Database Datagram Socket Server 


To increase the functionality of datagram sockets, database servers can join 
groups to provide common sets of services. The model we implemented portrayed an 
Infantry Battalion, consisting of companies. Each company maintains a repair parts 
database, consisting of a standard prescribed load list (PLL). The PLL consists of 
communications, weapons, and vehicle parts the unit is authorized to maintain for routine 
maintenance. The database should accurately reflect what spare parts the organization has 


on hand. A unit is authorized certain types and quantities of parts to be maintained, based 
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upon the units’ mission. The quantity on hand cannot fall below or exceed a specified 
level. 

Company PLL clerks can query their database for parts. As parts are consumed, 
an update is generated and the quantity is decreased. If a part is received, then the part 
quantity is increased. PLL clerks cannot delete parts from the parts table, or insert new 
parts into the table. For example, a Company PLL clerk cannot arbitrarily add part X to 
the database, or decide to stop stocking part Y. To change the prescribed load list the 
unit must make a request to Battalion. Units are authorized to laterally transfer parts, 
from one company to another to prevent systems from becoming non-mission capable. 

In the hierarchy, a Battalion oversees Companies and also maintains its own 
prescribed load list. The organization is responsible for monitoring the maintenance 
programs of its subordinate units. In our model, Battalion is authorized to coordinate 
with peer Battalions. Battalion is also authorized to add and delete items from the 
Company’s PLL based upon unit mission.To assist company clerks in locating parts, all 
company database servers are part of a Battalion multicast group. Each Battalion is part 
of a Battalion level multicast group. 

In the following example the A Company PLL clerk cannot find a specific tire, 
with a part id of 5433, so the clerk generates a request to all members of the group. Each 
database server will respond to the requestor if it can provide the part. The organizations 
can then coordinate to transfer the part to the requester. If the part cannot be found 
within the Battalion, a request is generated to the Battalion PLL clerk who multicasts a 
request to peer Battalion parts databases. If the part exists, through the hierarchy of 


multicast groups it will be found or ultimately ordered. 
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A Company 


1. check local invento 


2. multicast request 
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Figure 17: Multicast Parts Request 


The example above depicted the client process as being a database server group 
member, but the client could be a stand alone client application. For example, 1f a 
Company Commander wanted a parts inventory report, the application would send a SQL 
query statement to the database to collect information. Depending upon where in the 
hierarchy the commander was, he would dictate how many organization's PLL he would 
be able to view. 

By employing a middleware server the Commander may access a number of 
distributed heterogeneous databases. In our model, one database was a MS SQL 6.5 
database and the remaining databases were MS Access databases. 

By parsing the message, the specific business logic can reside at various levels. 
For example, if a CoParts inventory of widgets drops below a certain level, logic 


residing on the server may trigger a message or report to be sent to the parts manager. 


D. CONCLUSION 


Communication between computers ultimately goes through sockets. Regardless 
what types of messages are being passed, sockets will be required to make the 


communication happen. Implementing socket-based communication requires a 
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substantial amount of low-level programming. When it comes to database connectivity 
and database manipulation paradigm, writing all that low-level code becomes tedious. 

Commercial middleware solutions to the problem of database connectivity and 
database manipulation contain these low-level routines. But socket implementation 
allows developers to freely customize their applications depending on the users and/or 
administrators' need. The overall performance of the application can also be increased by 
this customization. 

One other thing that we experienced while implementing the model explained in 
section C was the power of using Java interfaces. Interfaces allowed us to separte the 
implementation logic from the GUI implementation. Through the use of Java interfaces, 
the logic modules were able to invoke methods declared in the interface. GUI objects 
such as frames, or dialog boxes would implement the interface. Parent threads and 
objects passed themselves via the "this" operator would allow subordinate threads and 
objects the ability to invoke methods defined in the interface and implemented by the 
GUI. This allowed those objects to display result sets, connection information and 


various messages passed and received. 
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V. REMOTE METHOD INVOCATION AND JDBC 


A. INTRODUCTION 


The low level details of socket programming hinders a designers ability to focus 
on interface development or efficient database access and results in a longer development 
cycle. An alternative to sockets is Remote Method Invocation (RMI), which abstracts the 
communication interface to the level of a procedure call. Instead of working directly with 
sockets, the programmer has the illusion of calling a local procedure, when in fact the 
arguments of the call are packaged up and shipped off to a remote object to process the 
call. 

Remote Method Invocation (RMI) is a powerful distributed computing 
technology that allows a designer to develop a networked application without having to 
worry about the low-level networking details. It is a Java distributed object solution that 
allows a Java client the ability to access a Java server, and invoke methods that the server 
makes available in its interface. RMI encapsulates the underlying mechanisms for 
transporting method arguments and return values across a network. 

Coupled with JDBC, RMI can be used to create a middle tier heterogeneous 
database server. A Java client will be able to invoke methods on a remote Java server. 
The server can employee JDBC to communicate with various relational database 
management systems. This implementation can reduce the system administrators burden 
of managing database access and client application configuration. All database 
management system drivers will reside on the server, resulting in zero client 
configuration. The client will not have direct access to the database, and will only be able 
to use the methods specified in the interface. Business Logic can also be stored on the 
server, so when a user attempts to access a database, the most recent organizational 
policies will be enforced. This chapter will provide an explanation of RMI and discuss a 
model that was implemented using RMI and JDBC to provide heterogeneous database 
access. 

RMI is a distributed object model. According to Coulouris “A distributed system 
consists of a collection of autonomous computers linked by a computer network and 
equipped with distributed system software. Distributed system software enables 
computers to coordinate their activities and to share the resources of the system — 
hardware, software and data”[Ref. 4]. 
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A distributed system can be visualized as a collection of server processes and 
their client processes. These processes do not necessarily reside on a same computer. In 
order for a client process to be served, it needs to find the server that offers the desired 
service, then send its request and wait for a reply. The server process may reside on the 
same computer as the client or on a remote system. A server may employee the services 
provided by another server, so it may also be considered a client process. Each service 
program has an interface defining the services it provides. These services may be invoked 
by clients. Clients invoke service operations by sending request messages to the servers, 
which perform the requested operation and send a reply back to the client. 

The Remote Procedure Calling mechanism integrates this client-server 
arrangement with a conventional local procedure call of a standard object oriented 
programming language. Since, the server and client processes may reside on different 
machines communication between them must be handled. The parameters being passed to 
the remote method and it's return types must be packaged for transmission across the 
network. Data structures must be flattened before transmission and rebuilt upon arrival 
on the other side. To flatten a data structure implies taking a complex object and 
breaking it down into a stream of bytes on the client side, then transmitting the data to the 
server object which will reconstruct the complex object and forward it up to the server 


object. 
B. REMOTE METHOD INVOCATION (RMI) 


RMI is Sun's version of RPC and translates well into distributed object systems, 
where communication between program level objects residing in different address spaces 
is needed. The following highlights key features of RMI [Ref. 16]. 


e Object Oriented: RMI can pass full objects as arguments and return values. 
The objects must be serializable, such as Java primitives or objects that 
implement the java.io.Serializable interface. For example, Java Vectors and 
Hashtables implement Serializable, so these complex objects can be passed to 
or from a client using RMI, with no additional processing. With RPC the user 
would have to decompose the object, send it and recompose it on the client. 
RMI encapsulates this process for the programmer in the form a client stubs 
and server skeletons that are responsible to marshal and unmarshal the data. 

e Implementation Changes: RMI can encapsulate the class implementation 


details from a client. Clients only have access to the interface, the 
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implementation resides on the server. So as business logic, or implementation 
details change, they only need to be changed on the server. As long as the 
interface signature does not change, the implementation details are totally 
encapsulated. 

e Rapid Development: RMI makes it easy to write servers for a full scale 
distributed object system. A server object implements the interface, declares a 
security manager, and binds the instantiated object to the rmi registry. 
Writing reliable distributed applications is simple. 

¢ General Goals: RMI supports seamless remote invocation of objects in 
different virtual machines, including call backs from applets. Remote Method 
Invocation (RMI) was designed to seamlessly support remote method 
invocations on objects across Java Virtual Machines. Because RMI centers 
around Java, it brings the power the of Java safety and portability to 
distributed computing. 

+ Garbage Collection: RMI uses a reference counting garbage collection 


scheme. It keeps track of the number of references to an object. 


One of the limitations of Java RMI is that Java must be run on both ends of the 
network connection. A Java client can only communicate with a Java server. But the 
Java server can communicate with non-Java applications such as a database management 
system. 

The following section will provide a more detailed explanation of the RMI system 


architecture, and how RMI encapsulates interprocess communication. 
1. RMI System Architecture 


Figure 18 highlights the three layers of the RMI system: the stub/skeleton layer, 
the reference layer, and the transport layer. An independent interface and protocol is 
defined for each layer allowing alternate implementations to be replaced without 
affecting other layers of the system. À remote method invocation from a client to a 
remote server object travels down the client stack, then up through the server stack, 
where the method gets invoked and the results are passed down the server stack through 


the network to the client and up the client stack. 
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Figure 18: RMI Architecture [Ref. 15] 
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a. Stub/Skeleton Layer 


This layer is the interface between the application (client and server 
applications) layer and the remote reference layer of the RMI system. Stubs and 
skeletons are used by the client and server processes respectively to communicate. Sun's 
rmic tool (rmi compiler) is used to generate a stub and skeleton class file from the object 
implementation class file. A stub/skeleton is generated for every remote implemention 
object that is made available to client applications via an interface. 

When the client application makes a remote method call, the parameters 
and call are passed to the stub layer. The stub layer is responsible for marshalling 
(flattening) the call. It then passes the call down the RMI protocal stack, which 
ultimately transmits the call across the network to the remote server. The call moves up 
the server stack to the skeleton layer. The skeleton layer is responsible for unmarshalling 
the call. The skeleton reformats the method call, then invokes the appropriate method of 
the instantiated implementation object. The method is executed and it's return values are 
passed back through the skeleton, where they are marshalled and returned to the client. 


The process is depicted in Figure 19. 
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Figure 19: Marshalling 


b. Remote Reference Layer 


The remote reference layer deals with the lower-level transport interface. 
This layer is responsible for carrying out the semantics of the invocation. For example, 
the remote reference layer is responsible for determining whether the server is a single ` 
object or is a replicated object requiring communications with multiple locations. The 
remote reference layer transmits data to the transport layer via an abstraction of a stream- 
oriented connection. When a server is exported its reference type is defined. If the server 
is a UnicastRemoteObject, then it is a point to point unreplicated server. This was 
designed to allow for modification and future expansion. For example, a 
MulticastRemoteObject, would have reference semantics that allowed for a replicated 


service. 
c. Transport Layer 


The transport layer provides the communication implementation between 
the client process and server process using TCP-based Java Sockets. It listens for 
incoming requests, establishes a connection (channel) to process the request, and 
manages the connection. A channel is a conduit between two address spaces, the 
transport layer manages the connection between the local and remote address spaces. 

When the client first establishes a remote reference to an object, the client 
must find that object on the network. To do so, the client performs a lookup. On the 


server an rmi registry process runs and continuously listens for messages on a 
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predetermined port. The clients lookup request moves down the RMI stack, the transport 
layer gets a port from the local operating system and sends the request to the remote 
registry process. The registry consults a table to confirm that the object exists, 1f 1t does, 
a communication channel (TCP/IP stream socket) is established between the client and 


the remote object. 
d. Application Layer 


The application layer sits on top of the RMI system. The client and server 
applications interface with the stubs and skeletons respectively. The server application is 
responsible for instantiating implementation objects. Once the object is instantiated it is 
bound to the registry making the object available to client applications. 

The client application is responsible for performing the lookup, to find the 
remote object and establish a communication channel. Once the channel has been 
established the client can invoke remote methods just as if the object resided locally. 
The only difference is that each method call must catch a RemoteException. RMI is 


synchronous, so the calling process will block until the remote method completes. 
2. RMI Development Process 


An RMI object is a remote Java object whose methods can be invoked from 
another Java Virtual Machine across a network. The following section outlines the steps 
in using RMI for distributed Java computing. Figure 20 depicts the process graphically, 


demonstrating the key steps. 
a. Agree Upon the Interface 


The first step in employing RMI is to agree upon the interface of the 
remote object. The object interface declares what methods are visible to the client, and 
what services the server must provide. The interface is the contract between the client 
and the server. The client must understand what parameters and return types each method 
requires so they can be handled properly. RMI allows complex objects to be passed back 
and fourth between the client and server process. For example, if the method returns a 
vector of hashtables containing various primitive types, the client needs to know this. The 
object that implements the interface must extend java.rmi.Remote and each method 


which is to be visible to clients must throw a RemoteException. 
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Figure 20: RMI Design Process 


a. Implement the Interface 


The next step is to implement the interface. The object that implements the 
interface must extend java.rmi.UnicastRemoteObject. Each method that is declared in 
the interface must be implemented by this object and must throw a RemoteException. 
The implementation can be simple or complex. For example, the implementation may 
use JDBC to establish a database connection, to a Microsoft SQL 6.5 server, which 
resides on another remote machine. The implementation details are hidden from the 


client. The only methods the client have access to are those specified in the interface. 
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The implementation can be modified or changed, as long as the signature 
does not change. This can be effective in storing business policies or logic on the server. 
The client makes a policy request, and will always get the current policy. If the policy 
changes, the changes are made on the server, and all future users will get the updated 
version. In the case of database access, 1f the back end database manage system changes 
from a legacy implementation to a newer implementation, the changes remain transparent 
tothe client. 

RMI provides a convenient means of partitioning a distributed system 
design between the logic and the application design. As end users continue to rely on 
graphical user interfaces, the application designers job is becoming more challenging. 
RMI allows the logic, or back end designers and application designers the ability to focus 
on their respective areas of responsibility. In most cases, the client, using the interface 


and it's declared methods will be the application designer. 
b. Object Server 


The object server is a file that contains a main function. The process 
instantiates and binds implementation objects. When the object server binds an . 


instantiated object, the name 1s registered with the registry service. For example: 


Naming.rebind("navyServer", new navydbImpl()); 


This call instantiates a navydbImpl() object which implements navydbInt, 
an interface. The function call Naming.rebind comes from the RMI Naming class. This 
call is used to obtain the services of the rmi registry, to register the new object with the 
name "navyServer". Rebind updates the mapping between the name, navyServer and the 
remote object instantiated by new. The registry will discard any previous binding to the 
name. 

One object server can instantiate and bind as many different objects as the 
system designer wishes. The application server may also be responsible for logging all 


requests that were received and processed by remote objects. 
c. Java Client Application 


The fourth step is to create the Java client application. The application will 
usually consist of the GUI for the end user. To utilize the services provided by a remote 


object, the client must establish a reference to the desired remote object. A URL based 
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naming scheme is used to perform a lookup for the instantiated implementation object. 
The request gets passed down the rmi stack to the transport layer, which makes a TCP/IP 
connection to the remote object. The server machine must have an rmi registry active, 
which consists of a listening thread. Once a connection is established the rmi registry 
performs a lookup in its local table for an object entry name that matches the name 


provided by the client. For example: 


navydbInt server - 


(navydbInt)Naming.lookup("rmi://131.120.1.91/navyServer"); 


The lookup method returns a remote object for the URL name: 
"rmi://131.120.1.91/navyServer" . The call returns a reference object to the client, which 
Is type cast into a navyInt object. Now the client can invoke the methods specified in the 


interface by using server.<methodName>. 
d. Run the System 


In order to run the system, the rmi registry must be started on the server 
machine. The rmi registry is a utility program provided by Sun, that listens for rmi 
requests. The registry registers rmi objects that have been instantiated and made 
available on that machine. Each server process can supports it's own registry, or one 
registry can support all the virtual machines on the server node, such as an application 
server. 

Once the rmi registry 1s active the object server can be started. As stated 
before, the object server, instantiates and binds implementation objects to the registry. 
For example if the server instantiates a navydbImp object and registers it with the registry 
under the name of navyServer, that object is now available to service requests. 

The final step is to start the client process. The client process can reside 
on the same, or different machine as the server. As stated before, in order for the client to 
interface with a remote object, it must instantiate the interface object and performs a URL 
lookup. It must reference the remote object by the name, to which it was bound on the 


server Side registry. 
C. RMI JDBC MODEL 


To demonstrate the capabilities of using RMI with JDBC we developed an object 
server that provided relational database access to a MS Access database, and a MS SOL 


69 


6.5 database. As depicted in Figure 21, all database drivers were stored on the object 
server. The Microsoft Access database resided on the same machine as the object server, 
and the Microsoft SQL 6.5 database resided on a remote system. 

The accounts database represented a financial database, while the navy database 
represented an organizational database. The object server instantiated an implementation 
of both the navy and the accounts database interfaces. The instantiations were bound to 
the rmi registry which made the interface implementation methods available for use by 
client applications. 

The client GUI was designed using Symantec Visual Café and provided various 
views of the database, and various database manipulation methods via the remote 


implementation objects. 
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Figure 21: RMI Implementation 


To demonstrate the potential of RMI coupled with JDBC the remainder of this 
section will explain the details of the system. The explanation will attempt to follow the 


design steps as outlined in the preceding RMI Development Process above. 
1. Interface 


An interface to each database was designed to provide a module design, and was 


called acctsdbInt and navydbInt. One interface could have been used to access multiple 
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databases. The data base methods made available to the client consisted of specific 
methods for the basic or naïve user and general, powerful methods for super users. The 
client was the application designer who was designing the front end interface. In creating 
the system the designers must agree on where the business logic will reside. In our 
model the logic was present on both the client and the server. 

For example, do the system designers want to give the application designer 
complete access to the database, to create tables, delete tables, and insert tuples. These 
are powerful options that can be made available in the interface, yet may only be needed 
by database or system administrators. Or does the system designer want to provide 
limited database access and manipulation, providing only high level methods. 

The following functions allow the user to directly manipulate the database which 
may be appropriate for a database or system administrator. In order to use these methods 
the user must have a general understanding of SQL and the structure of the databases. 
These methods were used by the GUI designer. For example, the client may enter a 
string in a text box and click on the submit button, which would call the 


executeSQLGetString remote method. 


//for database administrator GUI 

public abstract String executeSQLGetString(String 
sql)throws RemoteException; 

public abstract Vector getTableName()throws 
RemoteException; 

public abstract Vector getTableMetaData (String 


sgl)throws RemoteException; 


The first method allows a user to issue a basic SQL statement (CREATE a table, 
Delete a table or tuples, Insert data, or execute a Select operation). The two supporting 
functions are used to provide meta data about the databases to assist the user in writing a 
SQL statement. This type of interface may be appropriate for a database administrator, 
but most likely not for a basic user. It provides a dynamic means to view the contents of 
a database and its structure, without having any prior knowledge about the database. 

To demonstrate restricted database access the following methods were provided 
for the basic user. The user can add a new employee or view the current employees from 
the accounts database. 

public abstract String viewEmployees() throws 


RemoteException; 
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public abstract void insertEmployee (String name, 
boolean faculty) throws 
RemoteException; 


This restricts database access and manipulation to only the methods specified in 
the interface. Various views and database manipulation methods can be specified in 
various remote objects such as: a database administrator object, a clerk object, or a 
manager object. Each object would encapsulate the business logic, and views the client 
will have access to and can be easily modified on the server to reflect changing rules. 
The end user does not enter any SQL statements, but is limited to executing the methods 
provided. This provides limited database views and manipulation. 

RMI allows a means to pass behavior from the server to the client. This allows 
the client machine to evaluate and implement policy or business logic. The following 
function allows a client to get the current database access policy from the server. Ït 
returns an accessPolicy Int object. The implementation object implements serializable, 


so in can be transmitted via RMI. 


//returns an object that implements the accessPolicy 

puria bStractoseeecssPotuc e IntagetAccessPolvewm m 
throws RemoteException; 

public abstractamola addUser(Sering uid, String@eass) 
throws RemoteException; 


The policy object contains various methods including one called getAccessRights. 
To demonstrate how a policy can be maintained and modified on the server, yet 
implemented or enforced on the client a simple example was developed. To provide 
database access, the administrator enters the users name, password, and access code. The 
information is stored on the remote server, via the addUser method declared in the 
interface. The access code is used to determine what views and database manipulation 
functions are appropriate for the user, based upon the current policy. 

When a user logs onto a system, the current policy object is downloaded from the 
server. The object contains a function called getAccessRights, which takes the users 
name and password, performs a lookup to get the users access code. The access code is 
compared to the current policy to determine what view the user is authorized. Based 
upon this logic, the GUI frame that appears may be a super user frame, providing full 


database access or manipulation, or a simple user frame, providing limited access. 


72 


If the policy changes, and all personal that have an access code of X are 
authorized a different view, the policy is changed on the server, and the next time that 
users logs in he or she will get the new view. This implementation can be extended to 
provide more computationally complex data processing or error checking on the client 


machine to reduce network traffic. 
2. Interface Implementation 


The implementation details are completely hidden from the client. This allows 
the implementation to be modified, provided the method signatures do not change. In our 
model, the implementation utilizes JDBC to provide the database access and 


manipulation. 
3. Object Server 


The object server consists of an active process which instantiates various remote 
objects and registers them with the registry. In the model, the object server instantiated 


and bound two remote objects as depicted in the following code: 


public static void. mimiSbring. argan 
{ 
Ery] 
System.setSecurityManager(new RMISecurityManager()); 
Naming.rebind("acctsdbServer", new acctsdbImpl()); 
Naming.rebind("navydbServer", new navydbImpl()); 
}catch(RemoteException e) { 
system. ou. paint 1n("Remote Exception "C +ë)"; 
} 


lena main 


The names used by the server, acctsdbServer and navydbServer are the names that 
get registered by the registry. When a client performs a lookup, it must specify these 


names in order to create a communication channel. 
4. Client Application 


The client application is the graphical user interface designed for the end user. To 


the end user, how or where the data is stored is irrelevant. The end user is only 
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concerned that the application provides the services he or she desires. It is the 
responsibility of the interface designer to meet the end users requirements. 

The following briefly discusses some of the key methods used in the client 
application by the application or interface designers. When the application is initialized, 
it establishes a security manager and performs a lookup to connect to an instantiated 


object, for example with the name of "navydbServer". 


//Navy Data Base Object 
navydbServer - 
(navycdbiInt) Naming. lookup ("rmi://131.120.1.91/navydbServems 


If the lookup is successful, then a communication channel is established and 
managed by the transport layer of the RMI stack. The client now has established a 
reference to the remote object, navydbServer. If the user enters his password and is 
granted super user access, then when the GUI frame is created the remote method 
getNames() is invoked. 

When the client invokes navydbServer.getNames() a vector containing the table 
names of the database is returned. The names are displayed in a drop down menu for the 
client to use while writing SQL Statements. The database metadata function, used by the 
server implementation object, provides a dynamic view of the current state of the 
database. If new tables are added to the database, the next time an authorized super user 
frame is generated, the new table will be displayed. The remote object that implements 
this function only needs to know how to establish a connection with the database. This 
implementation separates the backend database implementation from the front end GUI 
implementation. 

To provide the user with additional database metadata, the client may select a 
table name from the drop down menu to invoke the 
navydbServer.getTableMetaData(String sql) method. The SQL statement that gets 
passed to the function is "select * from <selected table>. The server side implementation 
of the function creates a JDBC statement object, executes the query, and gets the 
ResultSet meta data. Based upon the metadata, the column names are extracted, placed 
in a vector and returned to the remote client. The implementation code is as follows (a 


valid connection has already been established to the database): 


SES A SS A ce lire ile ™ 


ResultSet results = stmt.executeQuery (sql); 
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ResultSetMetaData  rsmd - results.getMetaData(); 
Vector resultVector - new Vector(); 


Inescols — rsmdogetColumnosumbi); 


HOME = E. 1x « cols Ez E) 

{ 
String colName = rsmd.getColumnName (ix); 
resultVector.addElement (colName) ; 

"end for 

stmt.close(); 


return resultVector; 


The client application displays the column names in a drop down to assist the end 
user in generating a SQL Statement. The column display width and the column type 
could also be returned in the Vector. 

The user can then enter a SQL Statement, using the table meta data provided to 
assist in writing the statement. All super user SQL statements are processed using the 
executeSQLGetString method, which processes all basic SQL statements. This provides 
the super user the ability to create a new table, delete a table or execute a select 
statement. If a result set is returned, the remote object, places the contents of the result 
set in a string, inserting a delimiter between tuples and returns the string to the client. 


The client application can parse the string and display the results. 
D. CONCLUSION 


Remote Method Invocation provides a powerful means of creating a distributed 


database aware system. Some of the strengths of RMI are: 


e SetUp: All database client drivers and configuration remains on a central 
server node. This simplifies administration, requiring no database drivers to 


reside on client machines. 


e Scalability: The database being used can be replaced transparently to the 
client, provided the agreed upon interfaces do not change. The physical 
location of the database can be moved, and only the implementation details 


need to be modified, again, transparently to the client. 
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e Logic: All business logic or policies can reside on the server, and be 
downloaded and enforced on the client. This ensures all end users are 


complying with the most recent policies. 


e Communication: The RMI model encapsulates low level communication 
requirements. System designers are not concerned with socket programming, 
and communication protocols. They only need to agree upon the interface. 


Methods are used to communicate between a client and a server. 


e Modularity: By employing RMI the division of system design is simplified. 
Once the interface is agreed upon, the application designer can begin 
implementing the GUI. The database administrator manages the database. 
The business logic, regardless of how complex, can be designed and stored on 
the server. Implementation details can change at all levels of system design, 
provided the agreed interfaces do not change, with minimal impact on other 


system components. 
RMI is a Java client to Java server implementation of distributed object model. 


Coupled with JDBC the two packages provide an easy means of developing distributed 


applications. 
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VI MIDDLEWARE APPROACH 


Remote Method Invocation is a powerful technology which allows designers to 
customize their object brokers, embed logic on the server, and provide client applications 
with dynamic database access. The cost associated with this flexibility is the amount of 
programming required to provide a total solution (GUI, Logic, and Database Server), 
which can slow the development cycle and increase cost. The next layer of development 
abstraction is to use Rapid Application Development (RAD) Tools to design database 
aware applications. 

As Java technology matures, RAD tools are appearing that assist commercial 
designers in creating Java solutions. Tools that assist in building a graphical user 
interface allow designers to focus on the total system, and not overly commit resources to 
GUI design. For Java RAD vendors, a key technique to differentiate a tool, and gain 
market share is to extend the functionality offered by the tools to include database aware 
components. Database aware components are Java beans capable of providing database 
functionality. By adding this functionality, these tools can provide a total solution to Java 
designers, decreasing the cost associated in providing a database aware solution. 

This chapter will explore the capabilities of two Java RAD tools: Borland's 
JBuilder Client/Server Suite and Symantec's Visual Café. Each tool comes bundled with 
a proprietary Type III Net-Protocol/All Java Driver, to provide heterogeneous distributed 
databases access. These drivers are middleware servers, which process JDBC calls into a 
DBMS specific network protocol and communicate the result to the DBMS specific 
server. Table 2 depicts the desktop and client/server databases both middleware servers 
can connect to. A desktop database implies that the middleware server and the database 


should reside on the same computer. 


DeskTop DBMS Client/Server DBMS 
Dbase IBM DB/2 
Paradox Informix 


MS Access* Oracle 
FoxPro Sybase* 
MS SQL Server* 





Table 2: MiddleWare Database Access 


In attempting to use a reasonable mix of relational database access, one desktop 


and two client/server DBMS's were selected. Microsoft Access was chosen as the 
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desktop database due to it's availability. Microsoft SQL 6.5 server was selected due to its 
increasing popularity and market share as a client/server database. Sybase SQL server 
was chosen as a non-Microsoft solution. 

The middleware servers (Symantec dbAnywhere and Borland DataGateway) were 
connected to the databases as depicted in the figure 22. These middleware servers were 
the conduit between Java client applications and remote databases. A Java client would 
use the middlewares API to communicate requests. The middleware server would use 


JDBC to forward the request to the appropriate backend database engine. 


Client Middleware Server 


MS SQL 6.5 ds 


/ 


Server , Es Sybase SQL 


| M. Server 


Figure 22: Commercial Tools Evaluation Environment 





A. SYMANTEC VISUAL CAFÉ 


Visual Café 2.0 Database Development Edition was released in August 1997 and 
was one of the first commercially available Java Database RAD tools. The Database 
Development Edition version includes a dbAnywhere Type III JDBC server, as well as 
database aware components and wizards integrated within the IDE to facilitate relational 
database interface development. To properly use the database aware components 


provided by Visual Café, the dbAnywhere server must be properly configured. 
]. Server Configuration 


The middleware server must be running to enable the database aware component 
functionality. To provide heterogeneous relational database access, the system 
administrator needs to be familiar with the client/server DBMS that the dbAnywhere 
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server will interact with. In our example, the dbAnywhere server was going to intract 
with a MS SQL6.5 database, a MS Access database and a Sybase database, so the DBMS 
client utilities of the DBMS must be installed on the dbAnywhere middleware server, 


since it becomes a client to the SQL 6.5 server or Sybase server. 
a. Connecting to Microsoft SOL 6.5 Server Database 


To interface with the SQL 6.5 server, the fist step 1s to install the SQL 6.5 
client utilities on the dbAnywhere server machine. The SQL 6.5 Configuration Utility is 
used provide connection information to the SQL6.5 Server. For example, the network 
protocol used was TCP/IP. A server alias was provided (cryptologistServer) and the SQL 
6.5 server socket address entered as the connection string 131.120.1.226,1433. Port 
1433 is the default SQL 6.5 server listening port. dbAnywhere contains a proprietary MS 
SQL 6.5 driver so the final step was to use the dbAnywhere configuration utility to 


register the database. The specified data source URL was: 


jdbc: dbaw: //localhost:8899/SOL SERVER/ 
cryptologistServer/NSGDB 


Where the protocol was jdbc, with a sub-protocol of dbaw, running on port 
number 8899 of local host, with SQL Server engine, to access cryptologistServer, 
specifically the NSGDB database. Since the SQL 6.5 server utilities were used to register 
the alias cryptologistServer, and it's associated TCP/IP socket information, the 
SQL Server engine will invoke the appropriate driver, which looks to its registry to get 
the connection information for the specified cryptologistServer. 

An ODBC alias can also be created using the ODBC Administrator by 
adding a SQL server data source. This 1s not necessary since dbAnywhere contains a 
proprietary. driver, but was used for our RMI and socket implementation. The 
administrator will display the SQL server aliases registered by the SQL server client 


configuration utility. 
b. Connecting to Sybase SOL Anywhere Server Database 


This set up was similar to the Microsoft SQL 6.5 setup. The fist step 1s to 
install and configure SQL Anywhere 5.0 Client Utilities on the dbAnywhere server. This 
installs the appropriate Sybase drivers. Once the client utilities are installed the system 
database administrator must use the SQL Central utility to establish a network 
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connection. A connection profile must be created, which specifies the user 
identification, password, database name, and a server alias. A database start up box is 


available to specify startup options. 


By default the SQL Anywhere client broadcasts a request to identify a 
server on the network matching the server name specified, in our case heteroServer. 
Under most networking topologies the broadcast will not leave the sub-net, so if the 
server is on a different sub-net its IP address needs to be specified through command line 
parameters, entered in the database startup box. This was not intuitive and required a few 


days of research to realize we had to specify: 


dbclient -x tcpip{HOST = 131.120-2.3 }neteroServem 


The Final step is to configure dbAnywhere. To access a SQL Anywhere 
5.0 server, dbAnywhere uses the Sybase SQL Anywhere 5.X ODBC Driver. This 
requires using the 32 bit ODBC Administrator utility to create an alias to the database. 
The ODBC configuration followed the same procedure as the SQL Anywhere client 
configuration, including specifying the command line start up switches. Once the ODBC 
configuration was complete the dbAnywhere configuration utility was used to establish 
the connection. Even with this configuration, we could not connect to the SQL 
Anywhere server unless we used SQL Central to establish a connection first. Then the 
dbAnywhere connection was successful. 

Once the dbAnywhere server is configured to connect to the desired 
databases, when the designer users the Visual Café database aware components, they will 


refer to dbAnywhere to interact with the appropriate datasource. 
2. Database Aware Components 


As explained above, the administrator must understand the relational DBMS's that 
the middleware server is going to provide access to. Once the dbAnywhere server is 
configured designers can develop database aware graphical applications. 

Visual Café provides a database wizard that takes the designer through the 
process of connecting to a database, generating a query, and displaying the results neatly 


ina form. All code, including the query is generated by the wizard. 
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The wizard steps include: 

+ Select the dbAnyhwere server 

e Select a Datasource 

e Choose a table 

e Select columns to display 

e Specify column display component, (text area, list, checkbox) and label name 


e Select record operators, such as next, previous, and first 


The database aware project provides no additional functionality, other than asking 
the user to create an applet or application. The wizard generates a form view of the 
selected table. The program can be compiled and executed without requiring the designer 
to write any code. The wizard does not allow the designer to bind the query to a grid 
view (matrix of rows and columns) and does not allow the designer to enter a unique 
query. It only generates a subset of select * from table name. The limited record 
operators allows a user to look at the next or previous record of the result set, or to enter 
and commit a new record. The wizard works well to provide simple form view database 
aware application. 

Visual Café's Database connectivity 1s provided through symantec.itools.db.pro 
package, a Symantec extension of Sun's java.sql package. Designers cannot use Sun's 
java.sql package to connect to the dbAnywhere server, so therefor cannot use java.sql to 
perform any database manipulation. To display Symantic's version of a result set, the 
designer must use symantec.itools.db.awt package, an extension of java.awt package. So, 
in order to customize the database functionality provided by the database aware 
components the designer must understand these packages. The key objects used to 
provide basic database manipulation were: Session, ConnectInfo, and a RelationView. 

A Session object represents a dbAnywhere Session. A connection to a 
dbAnywhere server. This object establishes the connection with the dbAnywhere Server 
via a TCP network connection and provides access to the related dbAnywhere classes. 

A ConnectInfo object represents a specific data source name, the database the 
designer is connecting to via the session object. This object includes the database name, 
username and password. 

A RelationView object, is used to submit and display the SQL statement. This is 
the component that defines and maintains the result set. The result set handles record 
navigation and data manipulation. A RelationView object gets bound to a 
symantec.itools.db.awt component, such as a text field, or list box in order to display the 


information. 
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To graphically create these objects, the designer can drag and drop them onto the 
designer form view or the dbNavigator can be used to automatically create them. 
dbNavigator provides means to navigate across dbAnywhere servers, and the databases 
they offer to include the column names. The objects(database, column name(s)) can be 
dragged to the form designer and will create the required components (Session, 


ConnectInfo, and RelationView). 
3. Model Implementation 


Generating a form view of all tables was not difficult because of the wizard. The 
add table utility would launch the wizard and the selected table would be appended to the 
existing frame object. In most cases a new frame was created to display the table. This 
solution was not effective, because users would be required to open a new frame to view 
a table, which cluttered the desktop. We tried to use panels to display the contents which 
was more effective, but generated an excessive amount of code. 

One of the functions we implemented in the RMI model required a user to log 
onto a system, and a drop down menu would then be populated with data sources the user 
was authorized access to. To implement the same functionality with Visual Café, was 
challenging. A StringBuffer was used to format a SQL string, which was submitted and 
returned a Symantec relation view object. We were not able to bind the relation view to a 
symantec.itools.db.awt choice box, so the results were placed in a text field. 

When the user selected the data source, the goal was to create a connection to that 
source, and allow the user to get the database metadata which could assist the user in 
preparing SQL statements. These statements could be submitted and the results 
displayed in a grid box. Since, dbAnywhere does not support java.sql, to implement this 
would require a more thorough understanding of the symantic.itool.db.pro package which 
was beyond the scope of this thesis. We were able to use java.sql to establish a 
connection via Borland's DataGateway and use the result set to populate the choice 
component. In this case, a simple java.sql implementation was much cleaner than the 
Symantec implementation. Unfortunately, the only interface to a dbAnywhere server 1s 
via Symantec's API. Borland Datagateway accepted Borlands API and Sun's JDBC API. 

One of the shortcomings observed was that the wizard hard codes physical path 
name to the database. For example, when the add table wizard was used to connection to 
the Microsoft Access database that resided on the same machine as the dbAnywhere 


server, the following would be hard coded by the wizard: 
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( SELMeT TRO | Account] “PROM 
[C:\\dataBases\\Project97].[Travel]"); 


In this implementation, dbAnywhere used the JDBC-ODBC bridge to provide 
access to the data source. The database name was Project97, and resided in the dataBases 
subdirectory, on the C drive of the development system. Later, when the project was 
deployed to a separate machine, the physical location of the database was changed and 
the ODBC alias was updated. This resulted in the client application throwing an 
exception. The dbAnywhere server failed to encapsulate the physical location of the 
database. When the database was moved back to it's original location, the client 
application worked fine. This failed to support a true client/server model and was a 
serious shortcoming. This problem was not apparent for the MS SQL 6.5 database. 

To deploy the application a Jar utility function exists within the IDE. It can 
consolidate all required classes and create a Jar file or a zip file to facilitate distribution. 
To provide database access via dbAnywhere, the dbaw.zip and dbaw_awt.zip files can 


also be included in the Jar file. 
4. Visual Café Summary 


The integrated development environment (IDE) provided by Visual Café does 
not have a Java RMI compiler. The awt visual design tools are outstanding for creating a 
graphical user interface and fast compilation time is refreshing. Its database functionality 
1s effective for simple form view data access and manipulation, but lacks the flexibility to 
be an effective enterprise development tool. One of the biggest limitations 1s that Visual 
Café only provides JDBC access through the dbAnywhere server. This requires the 
designer to learn Symantec's database API. Learning a proprietary API defeats the 
purpose of using Java. Also, all database aware components and wizards will only work 
with a dbAnywhere server, making the application reliant upon a proprietary server. 

This also constrained how dbAnywhere could be used as a database gateway. For 
example, it may be effective to use the proprietary JDBC drivers (MS SQL6.5 or Sybase) 
in conjunction with an RMI implementation. The client could call the RMI object server, 
which could use java.sql to interface with the dbAnywhere middleware server, but 
dbAnywhere has a proprietary interface, so the interface will have to be via a Symantec 
package. 

Visual Cafe also does not provide any integration with legacy data and transaction 


systems and the IDE is not integrated for Java RMI . The next version of Visual Café is 
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expected to offer integrated JDBC support.[Ref. 3]. For simple form views and rapid 
design, Visual Café is an effective tool. Java.sql is the JDBC standard interface, so most 
Java database designers are going to be reluctant to invest time and resources into 


learning Symantec's version of a database API. 
B. BORLAND JBUILDER CLIENT/SERVER SUITE 


Borland JBuilder Client/Server Suite version 1.01 is one of the most powerful and 
complete tools for developing Enterprise, pure Java database aware applications/applets. 
The JBuilder component palette 1s decorated with many database aware objects to display 
and manipulated data. 

JBuilder comes with a type three JDBC driver (network-protocol/all-Java driver) 
called Borland DataGateway. It provides developers a multi-tier, fast and reliable 
database connectivity solution. Borland DataGateway is a collection of JDBC drivers that 
allow Java applications and applets on any platform to access both the desktop databases 


and client/server databases listed in Table 2. 
1. Server Configuration 


Borland DataGateway consists of four major parts. First the DataGateway Client 
which may be either LocalDriver.class or RemoteDriver.class. This driver communicates 
with the DataGateway Server using the TCP/IP protocol. It is downloaded with the Java 
database aware application/applet. Second is the DataGateway Server, which manages 
the transfer of information and calls between the Client and the Bridge. The bridge 
translated the calls that come from a Java application/applet to a protocol understood by a 
database engine. The final part is the engine which communicates with the vendor 
specific database management system drivers, or the ODBC API. 

Borland DataGateway uses the Borland Database Engine (BDE) and SQL Links, 
which supply both native DBMS drivers and ODBC drivers, to provide heterogeneous 
relational database connectivity. In order to connect to the client/server databases, the 
DBMS specific client utilities, in our case MS SQL6.5 and Sybase, must be installed on 
the machine where Borland DataGateway Server is running, similar to the dbAnywhere 
configuration. The BDE Administrator utility, which comes with the DataGateway, lets 


developers create aliases to the actual databases. 
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a. Connecting to Microsoft SOL 6.5 Server Database 


As we have pointed out earlier, the client utilities of SQL 6.5 must be 
installed before interfacing with the SQL 6.5 server. The steps for the installation and the 
configuration of client utilities are exactly the same as explained in dbAnywhere SQL 6.5 
configuration. 

The important thing here is to bind a server name to a valid IP address and 
a port number where the actual SQL server is running. This server name will be 
referenced inside the BDE Administrator while creating the alias to the SQL 6.5 
database. 

Once  aliases have been established and the server is running, 
connections to the databases can be done by using either the Remote Driver (for both 
local and remote databases) or the Local Bridge (for local databases only) in the 


following ways. To invoke and register the Remote Driver class, call the Java method: 


Class.forName("borland.jdbc.Broker.RemoteDriver"); 


For example, to the data source URL for the NSGDB data base was: 
jdbc:BorlandBroker://131.120.1.91/NSGDB, where jdbc is the protocol, with a sub- 
protocol of BorlandBroker and DataGateway running on the machine whose IP address is 
131.120.1.91 and NSGDB is the alias to the database which might reside on that machine 
or on a different machine that has a SQL server running. To invoke and register the Local 


Driver class, call the Java method: 


Class. forName (“borland.jdbc.Bridge.LocalDriver”); 
2. Database Aware Components 


Jbuilder defines its own components to provide database connectivity. Borland 
has created many APIs specific to JBuilder that abstract some of the Java APIs in order to 
provide database connectivity and data-aware object creation. The package 
borland.sql.dataset has been created to provide data connectivity functionality that is 
JDBC specific. Its classes are used in conjunction with the classes in the 
borland.jbcl.dataset package, which provide general routines for data connectivity and 


data management and manipulation. 
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DataSet 1s an abstract class in borland.jbcl.dataset package to provide a cursor for 
accessing and navigating table data. The DataSet abstract class has been extended by 
additional Borland classes so that data-aware objects can store the data. 

StorageDataSet class (extends DataSet) has been created to support easy and 
flexible manipulation and navigation of data in a common way regardless of how the data 
was obtained. Data can be obtained from a remote server through the use of a query (or 
QueryDataSet, which will be explained later). After data is stored in a StorageDataSet, it 
can be connected to the data-aware objects to display and manipulate. 

In order to connect to and retrieve data from a database, even though the straight 
JDBC calls can be used throughout the application, JBuilder's borland.jdbc.dataset 
package offers many high level objects. The Database class encapsulates a database 
connection through JDBC to a data source and provides transaction support using local 
caching. A Database object that has a connection to a database can be created by the 


following Java statements: 


Database db = new Database(); 

db.setConnection (new 
borland.sql.dataset.ConnectionDescriptor 

(be -Borlendbroker-//1:l. 120441 01/SOlbE Uses 


DES SNS = wer OMR C. PEOKCrAKemOoL SD ver sc 


A ConnectionDescriptor object requires the data source URL as a first parameter, 
then user id, password and finally the JDBC driver class name. JBuilder will generate all 
of the statements above for the developers. 

After creating a Database object that will handle the JDBC connection to the SQL 
database and a QueryDescriptor object to store the query properties, a QueryDataSet 
component (from borland.sql.dataset package) can be easily created. The QueryDataSet 
component is an extension of its superclass (StorageDataSet) and provides functionality 
to run a query against a table in a SQL database. The data contained in a QueryDataSet 1s 
the result of the most recent query. The "result set" from the execution of the query 1s 
stored in the QueryDataSet, allowing tremendous flexibility in navigation of the resulting 
data. 

DataModule is a powerful interface which developers implement when creating 
multiple GUls that will use the same data model in one application/applet. For example, 
a designer will instantiate a DataModule object, and then will be able to graphically drag 
and drop database query components into the object. This centralizes all database 
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requests in one object instead of having it dispersed throughout the client code. 
According to JBuilder's online help manual "Data modules (often referred to as data 
models) are specialized containers where data access components and their associated 
properties are collected into a reusable component....The data module also provides a 
centralized location where "business logic" can be stored. "Business logic" describes the 
rules by which data is manipulated before and after the user (or client) sees the 
data."[Ref. 2]. One of the most important reasons to have a data model concept in the 
application/applet is to be able to access a single instance of the data model shared across 
the application/applet instead of allocating memory for multiple instances. 

JBuilder offers many data-aware objects which have the ability to display and 
manipulate data. A Grid object can be used to display data in a tabular format and be 
modified by updating the appropriate cell. All JBuilder data-aware components are 
strictly tied to the JBuilder's database APIs. When a developer wishes to use Sun's JDBC 
calls in order to make objects display data, a conversion must be done from the java.sql 


objects to borland.sql.dataset and/or borland.jbcl.dataset objects. 
3. Model Implementation 


An application and applet were created which provided database connectivity 
through the DataGateway server. The MS Access database resided on the same machine 
as the DataGateway server, and the MS SQL database resided on a remote machine. 

Creating the application was very quick and easy by using the objects and the 
methods provided in the JBuilder environment and APIs. The Remote Driver of 
DataGateway was used to handle the connection to both databases. We were able to 
easily implement a user log on, and display of the data sources the user had access to, as 
implemented in the RMI. With Jbuilder navigating among the data that was stored inside 
the DataSet objects was very flexible. When the user selected the data source, a 
connection to that source was created. A frame that contained the data-aware components 
was then opened which allowed users to view and manipulate the data. 

Two choice control objects were added to the frame to allow users to change the 
data set view of the grid control object to a different table. One of the choice control 
objects displayed the table names. This was accomplished using straight JDBC calls. 
This proved that even though we were using JBuilder objects we could use appropriate 
JDBC calls to manipulate them. For example borland.sql.dataset package provides a 
Database class method (getMetaData()) which returns a JDBC DatabaseMetaData object. 
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Converting from application to applet 1s easy as long as certain applet restrictions 
are met such as, there should be no menu objects. [f the application is modular enough to 
have reusable components, like generic frames and data modules, then using those 
components in applets will save time in this conversion process. 

After finishing the implementation of the application, we used the deployment 
wizard to create a Jar file (or it can create a zip file) which contained all the necessary 
class files (either Borland JBuilder proprietary or JDK 1.1) to facilitate distribution. 
Since the application was using Borland DataGateway Client to communicate with the 
server for providing database access, we shipped broker.zip (contains client class files) to 
the machines where our application was running. Detailed deployment issues can be 


found in the Appendix D. 
4. Summary 


The integrated development environment (IDE) of JBuilder Client/Server Suite 
provides an effective environment which makes projects easier to manage and organize. 
DataGateway is an effecitve type III Java driver that can be used by any client application 
via java.sql or whose functionality can be extended via Borland's database API. The 
interface to DataGateway allows visual database components to be used for database 
access and manipulation. JBuilder also contains a set of SQL tools, including a SQL 
Builder, which allows developers to create flawless drag-and-drop queries for 
QueryDataSet objects. | 

Even though JBuilder's database aware objects are tied to the JBuilder specific 
APIs, most of the classes provide methods to handle JDBC calls where customization is 
needed. When it comes to customizing the application/applet, JBuilder specific APIs 
must be learned in order to reduce the overhead associated with the conversion between 
JDBC methods and JBuilder database methods. JBuilder IDE offers an effective online 
help manual where all Java APIs and JBuilder specific APIs have been documented. 

As a suite, Borland DataGateway can be used to provide database access, via 
java.sql calls. Developers can use the middleware driver in an RMI or socket 
implementation, which may not use Jbuidler's database aware GUI components. The 
IDE also includes support for Java Remote Method Invocation (RMI), so developers do 
not need to exit the JBuilder IDE in order to run the rmic compiler. JBuilder also comes 
with integrated CORBA/IIOP development tool that allow interoperability between 


objects built in different languages, running on different machines or running in 
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heterogeneous distributed environments. Borlands Jbuilder is an effective Java enterprise 


development tool. 
C. CONCLUSION 


One of the primary limitations of using a Commercial Java Database Solution is 
that the designer cannot manipulate the "black box" middleware server. The middleware 
server provides the access to the data source, but does not provide room for the designer 
to embed any logic, so all logic must be embedded in the client application. This does 
not provide a solid base for distributed computing solutions. This brings up the 
flexibility provided via an RMI implementation, where you can install the logic wherever 
it is convenient for the application. In the Symantec and Borland models, the client 
application was making database specific calls, to a backend database engine via a 
middleware server. The client code was directly tied to the backend database, which may 
be a limitation. 

Another limitation, is that designers are forced to learn a propritary API to take 
full advantage of database aware components in using the tools to design the user 
interface. At least with Jbuilder, the Java.sql package could also be used, providing the , 
designer the flexibility to use the most appropriate API to perform a task. This also re- 
enforced that Borland Datagateway can be used as a middleware solutions in designing a 
database aware system. Symantec's dbAnywhere was only effective in implementin a 
Symantec solution. For example, dbAnywhere could not be used as a type III 
middleware driver in our RMI model, because it does not understand the java.sql API. 

The implementation details are embedded in the client application, making the 
code harder to understand. This may affect future code maintenance issues. For 
example, the tools embed database functionality throughout the file. With the RMI 
implementation all database manipulation functions went through a database logic 
module, which provided a cleaner separation. 

From the GUI designer’s point of view, the RAD tools drastically decreased the 
overhead associated with creating professional looking database aware application. So 
depending upon the clients specifications, these tools are appropriate for simple form or 


grid database aware applications. 
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VI. CONCLUSION 


A. SYNOPSIS 


Java is prepared to provide Enterprises relational database solutions. Sun's Java 
Development Kit provides standardized packages which can be used for distributed 
computing solutions. As demonstrated in the models, Java's sql package provides a robust 
means of relational database access and manipulation. The communication link in 
distributed computing can be resolved by using Java's net package for a customized 
socket solution, or Java's RMI package for a more powerful object solution. The three 
models we implemented demonstrated some of the capabilities and limitations of 
combining the communication and the database requirements in providing a client/server 
relational database aware system. The technology selected by a designer will depend 
upon the customer's system specifications. 

The multicast model, provided a customized way to allow clients to be servers 
and to join multicast groups. This allowed group members the ability to multicast a 
query to other group members who would service the request and respond. The 
capabilities of the server objects were implemented in various logic modules. This 
technology could also be used to analyze the database's of an organization to perform 
statistical analysis. The price associated with this flexibility was the time 1t took to 
implement the low level network protocol and define the communication protocols. In 
this implementation there was no single dedicated database server. Each application 
embedded database calls in its database logic module to connect to its local database 
server. When a client application joined a multicast group, it then became a server. 

Remote Method Invocation was the next layer of abstraction. This technology 
encapsulated the low level network programming concerns, and allowed servers to pass 
objects to client applications. Multiple remote objects provided various services to client 
applications. In our model, a client would log onto the system via the RMI administrative 
object which used JDBC to access an authorization database. It would ensure the client 
was authorized access to the system and return a vector of databases the user was 
authorized access to, which would populate a choice component. When the user made a 
selection, the request would go to the RMI database object, which would provide 
database functionality. In this implementation all database access and coordination was 
encapsulated in the remote objects (servers). This implementation required system 


designers to develop interfaces, implementation details and client applications. 
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The commercial tools provided a one stop solution for simple database aware 
systems. dbAnywhere and DataGateway JDBC drivers provided the link to various 
databases. The client application would contain that approriate classes that would allow it 
to talk with the middleware driver. Database aware components facilitated designing the 
client interface and in providing database manipulation. To take advantage of the 
database aware components, we had to use the vendors version of database API instead 
of java.sql. These tools provided a professional view, which is important for IT managers 
to convince leery Enterprise managers to install Java applications on their Windows 
desktop. The cost associated with the RAD tools was the decreased flexibility to 
customize system solutions, and the requirement to use a proprietary database API. For 
example, with RMI business logic could reside on the server, and be enforced on the 
server or dynamically downloaded to the client to enforce. With the Java RAD tools, the 
server is an untouchable black box, requiring the policy to be embedded in client 
applications. This requires system administrators to ensure clients are using the most 


recent version of each application. 
B. AREAS FOR FURTHER RESEARCH 


The objective of this thesis was to demonstrate how Java Database Connectivity 
can be used to access heterogeneous relational database's in a client/server environment. 
The models implemented demonstrate various configurations that can be used to provide 
a database aware solution. There are a number of areas that warrant future research to 
confirm the technology is prepared for commercial implementation. It is our assessment 
that Java Remote Method Invocation provides the most robust area for distributed 
computing solutions, so the majority of our recommendation for further research are in 
regards to RMI. 


1. Security 


As distributed computing becomes more and more widely accepted and 
employed, the assorted security risks associated continue to increase. This thesis did not 
explore the security issues associated with distributed Java computing. According to Sun, 
Java was designed for network based computing and security measures are integrated into 
Java's design [Ref. 8]. In order to convince managers to accept a Java distributed 
solution, it would be essential to understand the security strengths and weaknesses of the 


technology. 
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With the introduction of JDK 1.2, RMI enhancements makes it possible to use 
Secure Socket Layer (SSL). SSL is a network protocol that encrypts data sent and 
returned from the remote object. If the information is intercepted 1t is unreadable. It also 
ensures that client applications are dealing with legitimate servers and that only 
authorized clients are able to connect to the server. This reinforces RMI as a solid 


distributed computing technology. 
2. Application Server 


One of the attractive features of Java RMI is the ability to transport objects that 
are serializable across the network. Java's awt package provides the objects to implement 
a graphical user interface and java.awt.Component class implements serializable. 
Container extends the component class, and Window extends the Container class, so in 
concept a graphical user interface is serializable. This means that a user can log onto a 
system, and make a method call to the RMI implemented application server, to get user 
interface X. The interface will then be downloaded to the client. This will ensure the 
client gets the most recent version of the interface, and streamline and organizations 
version control. This is important in organizations that constantly change their database 
aware applications, or have a dynamic workforce. 

For example, if a user is promoted, the database administrator grants the user 
access to the new database, say the maintenance database. The database administrator 
also updates the users access authorization via the remote RMI data admin object. When 
the user logs on, a list of databases the user is authorized to access is returned, and 
populates a choice box. Since this may be the first time the user has seen the 
maintenance database as a choice, he may not have the interface residing on his local 
machine. When the user selects the maintenance database it invokes a method to get 
maintenance interface version X. Since different clients will be authorized different 
views and privileges, the version number depicts what the user is authorized. 

The interface gets returned to the client application to be displayed. When the 
user makes a selection, a request goes to the RMI database broker, that implements the 
access. Such a dynamic use of RMI provides a solid means for organizations to control 
which version of an application a client is using. If the application gets modified, the 


next time the user logs on, he or she will get the most recent version of the interface. 
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3. Multicast Remote Objects 


Our RMI implementation extended UnicastRemoteObject which provides support 
for point-to-point active object references using TCP-based streams. As organizations 
depend on information for critical information, fault tolerance becomes an issue. With a 
single remote object implementation, if that remote object is not available, the system 
will fail. A remote object may not be available due to the remote system going down ora 
network failure. RMI also supports a MulticastRemoteObject. In this circumstance the 
request will go to multiple remote objects. This provides the fault tolerance mechanism 
that Enterprise organizations require for distributed computing. Quality of service factors 
may also be considered with multiple remote objects. The client makes a remote method 
call, and transparently the request goes out to N remote objects. If one remote server is 
overloaded, it may not be able to process the request in a timely fashion and depending 
upon how the client application was designed may block the client process from doing 
any additional work. With multiple remote objects, there is a higher probability that one 


of the remote objects will be capable of responding. 
4. Object Oriented Database 


As network bandwidth continues to increase, more complex objects such as video 
segments, audio segments and pictures continue to be sent. Object oriented databases 
provide a more suitable means to store the objects. It would be interesting to demonstrate 
how a heterogeneous RMI database server could be developed using RMI. The remote 
object may be able to provide access to relational or object oriented databases, 


transparently to the client. 
5. Common Object Request Broker Architecture (CORBA) 


Java RMI only allows Java clients to talk with Java servers. In the ubiquitous 
world of computing, the next level is to implement an object broker that 1s not language 
dependent. A CORBA implementation could provide the next level of generality. A 
performance comparison between our implementation and a Java/CORBA 


implementation would be interesting. 
C. CONCLUSION 


Java's platform independence is an attractive feature for many Enterprise 


organizations. Developer's enjoy the language because it is robust, fairly easy to learn, 
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and provides enormous flexibility. One of the strengths of Java technologies is that is 
allows designers to provide a total system solution in one programming language. Java 
technologies can be used to provide internet functionality via applets, for creating 
complex graphical user interfaces or for creating a distributed computing solution. 

As the technology matures, so will development tools and JVM perfromance. 
Initially these tools encapsulated and automated designing and implementing a graphical 
user interface. This allows designers to focus on providing an effective solution, not on 
the details of implementing an interface. The functionality of these tools continues to be 
extended to encompass and automate database manipulation, and in Jbuilder case, to 
interact with CORBA. 
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APPENDIX A. JDBC REFERENCE TABLE 


DriveManager 


Methods Purpose 






getConnection(String url, String id, String Returns a connection object to the database 






password) located at the url. 







Connection 






Methods Purpose 


close( ) Closes the connection to the database 















commit () Update the table with the changes. 


Required if user has disabled autoCommit 






SetAutoCommit(boolean) Allows user to explicitly set to autoCommit 





to false 





GetMetaData( ) A. Connection's database is able to provide 





information describing its tables, its 






supported SQL grammar, its stored 






procedures, the capabilities of this 





connection, etc. 






CreateStatement( ) Returns a statement object. A Statement 





object is used for executing a static SQL 






statement and obtaining the results 





produced by it. 
A SQL stored procedure 






PrepareCall(String) 
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APPENDIX A. JDBC Reference Table (cont.) 


Statement 


Methods Purpose 
execute(String sql) Executes the SQL statement, returns true 1f 
the first result is a ResultSet and false if it 
is an int. Useful if designer does not know 
if the SQL statement was a result 
producing SQL statement. 
ExecuteQuery(String sql) Executes the SQL statement, returns the 


result set containing the query results. 
Useful for SELECT statements. 
ExecuteUpdate(String sql) Executes the SQL UPDATE, INSERT, 


DELETE, CREATE statements that do not 
produce a ResultSet. Returns an int of the 
number of rows affected or zero 

GetMoreResults( ) Moves to a Statements next result. It 
returns true if this result is a ResultSet. 
getMoreResults also implicitly closes any 
current ResultSet obtained with 
getResultSet. 

GetResultSet() Returns a ResultSet if there are results, else 


returns null 





ResultSet 
Methods Purpose 

GetMetaData() Returns a ResultSetMetaData object which 
contains the number of 

getX XX(int columnIndex) Used with CallableStatement Objects. 
Retums a data type represented by the 
XXX (long, string, int, object) containing 
the value in the current row based upon the 


column index. 


getX XX(String columnName) Same as above, based upon column name 
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APPENDIX B. MULTICAST SOCKET MODEL 


This appendix provides the source code for the multicast socket implementation. 


It is organized from the graphical user interface, down through the logic modules as seen 


joinGroupDlg 


in the following figure. 
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Figure 23: Multicast Model 
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The evaluation environment must be set up exactly as described in Chapter IV in 
order not to have problems during the execution of the program. The model is 
implemented as follows: The object server (objectServer.class) must be started on a 
machine where the 1_BnParts database is (in our environment, it was on "roxanne"). The 
object server will create the 1_BnParts object, which will handle the requests that can not 
be handled by the other database server objects and forwarded to it. Once the object 
server 1s up and running, the main frame object can be started on the remote machines. 
This frame object is the initial frame on which users have accesses to create the database 
servers (in this case, a CoParts, b CoParts and c CoParts), initialize multicast groups 
and send messages either directly to a server or to a group. 

The a CoParts and the b CoParts database server objects need to be created on 
the same machine where object server is running. In our evaluation environment we 
created the c CoParts database server on a remote machine, namely "fido", which had a 
data source name defined to the c CoParts database on machine "cryptologist". 

Database server objects have to be alive, in order to process a request. If a 
message 1s sent before the database server 1s created, then that request will be timed out. 
From the initial frame (we called it as mainFrame), users can open up the listenFrame of 
database server objects ( by clicking the appropriate name of the database server from the 
DataSource menu item) in order to activate their listening threads for receiving requests. 
Clicking the "start listening" button on listenFrame initiates the listening thread of that 
database server. Then created database server starts to wait for a request from its listening 
port and each received request will be displayed in the list box of the listenFrame. 

Sending a direct request to a server can only be achieved from the main frame by 
selecting the request type (db, net, and response) and the recipient and by typing the 
message. Message types and their usage have been explained in Chapter IV in detail. 

Multicast groups are formed by making the database server object join a the 
group. From Group | InitializeGroup menu item (on the main frame) the joinGroupDlg 
dialog box can be opened. The multicast group IP and port number and the name of the 
database server object must be specified on that dialog box in order to send a "join" or a 
"leave" message. When the object either joins or leaves the group successfully, 1t returns 
an acknowledgement message which will be displayed inside the responses window in 
joinGroupDlg dialog box. When a server object is a member of a multicast group, that 
means, its multicast listening thread is running. When it leaves the group, its multicast 


listening thread is destroyed. 
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A database server object can be a member of multiple multicast groups. In that 
case, 1t will have that many multicast listening threads, and each one will be listening on 
different port numbers. 

From the main frame, by going through Group | Multicast Send menu items, one 
can send a multicast message by supplying the necessary information (Multicast Group 
IP address, port number and message) on the Multicast Request frame that pops up. 
Multicast Request frame (mcSendFrame) allows to specify the request type, multicast 
eroup IP and port number and the number of replies being waited after sending the 
request (normally, it will be the total number of group members) and the actual message 
body. The list box inside the Multicast Request Frame displays the replies in the order 


they are received. 
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JA EEEk k k k e e e e e e d d de de de de de de de de d de de de de de de de de de de ke de de k de de de de ke e de de ke ke de de de e de ke de de ke K ke ke ke ke K e ke ke ke 


//File: mainFrame.java 

//Purpose: Initial frame, that allows user to create the db server 

TR objects, open up the the multicast frame GUI implemented 
11 with Visual Cafe 

f| | Foe e ce ee ee ee e de de de de de de de de de de de de ke ke ke de ke de ke de de de de ke de de de de ke de de de ke *% de K K e ke de K e d K K ke K d e e ke ke k k 
import java.awt.*; 

IMPOEC Java-util.", //É0r vector 


public class mainFrame extends Frame implements vectorInt 
( 

networkUtil network = new networkUtil (); 

Vector resultVector = new Vector(); 


public mainFrame () 


{ 


//((INIT CONTROLS 

setLayout (null): 

setVisible (false); 

setSize(insets().left + insets().right + 550,insets().top + 
insets() .bottom + 400); 

openFileDialogl = new java.awt.FileDialog(this); 

openFileDialogl.setMode(FileDialog.LOAD); 

openFileDialogl.setTitle("Open"); 

//$$ openFileDialogl.move (40,277); 

panell = new java.awt.Panel(); 

panell.setLayout (null); 

panell.setBounds (insets().left + 12,insets().top + 12,528,144); 

add (panell); 

requestTypeChoice = new java.awt.Choice(); 

requestTypeChoice.addItem("db"); 

requestTypeChoice.addItem("net"); 

requestTypeChoice.addItem("response"); 

panell.add(requestTypeChoice); 

requestTypeChoice.setBounds(96,0,118,24); 

sendToChoice = new java.awt.Choice(); 

Sendtocno.1ce .additem( agGorartts ); 

sendmechodyceSsssFtemi DES eS) 

sendToeielce additemiue eorarts jy 

panell.add(sendToChoice) ; 

sendToChoice.setBounds (96,48,117,18); 

labell = new java.awt.Label ("Request Type:"); 

tabell.set Bounds (12,0,108, 24); 

panell.add(labell); 

label2 = new java.awt.Label ("Send To:"); 

label2.setBounds(12,48,72,12); 

panell.add(label2); 

label3 = new java.awt.Label ("Message or Request"); 

label 3.setBounds (300,60, 163,16); 

panell.add(label3); 

messageTextField = new java.awt.TextField(); 

messageTextField.setBounds (228,84,288,25); 

panell.add (messageTextField); 

sqlChoices = new java.awt.Choice(); 

sqlchoices.addltem(" INSERT INTO parts VALUES(U2, ‘trailer jge50, 1) 57 

sqlChoices.addItem("DELETE FROM parts WHERE part = 'muffler'"); 

sqlChoices.addItem("CREATE TABLE invoices(id int, supplier char(20))"); 

sqlChoices.addItem("SELECT * FROM parts"); 

sqlChoices.addItem("UPDATE parts SET quantity = 10 WHERE part = ‘brake 
pad” "e 

sqlChoices.addItem("DROP TABLE testTable"); 

sqlChoices.addItem("SELECT part FROM parts WHERE part = 'tank'"); 
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E 

sdichoxsces.select(-1):; 
) catch (IllegalArgumentException e) ( ) 
panell.add(sqlChoices); 
sqlChoices.setBounds (228,24,276,24); 
label4 - new java.awt.Label("Sample SQL:"); 
label4.setBounds (324,0,78,21); 
panell.add(label4); 
sendButton = new java.awt.Button(); 
sendButton.setActionCommand ("button") ; 
sendButton.setLabel ("Send") ; 
sendBurton.sectHounds(396,120,805425); 
sendButton.setBackground (new Color(12632256)); 
panell.add (sendButton) ; 
clearTextFieldBttn = new java.awt.Button(); 
clearTextFieldBttn.setActionCommand ("button"); 
clearTextFieldBttn.setLabel ("Clear"); 
clearTextFieldBttn.setBounds (288,120,80,25); 
clearTextFieldBttn.setBackground (new Color(12632256)); 
panell.add(clearTextFieldBttn); 
timeOut = new java.awt.TextField(); 
timeOut.setText ("15000") ; 
timeOut.setBounds (108, 96, 60, 22); 
panell.add(timeOut) ; 
timeOutLable = new java.awt.Label("Set TimeOut (ms):"); 
timeOutLable.setBounds (0, 96,96,20); 
panell.add(timeOutLable) ; 
panel2 = new java.awt.Panel(); 
panel2.setLayout (null) ; 
panel2.setBounds (insets().left + 12,insets().top + 168,528,200) ; 
add(panel2); 
resultSetList = new java.awt.List(0, false); 
panel2.add(resultSetList); 
resultSetList.setBounds(12,12,504,180); 
clearListBttn = new java.awt.Button(); 
clearListBttn.setActionCommand ("button") ; 
clearListBttn.setLabel("Clear ResultSet"); 
clearListBttn.setBounds (insets().left + 216,insets().top + 372,96,28); 
clearListBttn.setBackground (new Color(12632256)); 
add(clearListBttn); 
setTitle("Simulation Manager"); 


LLY 


//((INIT MENUS 
mainMenuBar - new java.awt.MenuBar(); 
menul - new java.awt.Menu("File"); 
miExit = new Java.awt.Menultem("Exit"); 
menul.add(miExit); 
mainMenuBar.add (menul) ; 
group = new java.awt.Menu ("Group"); 
joinGroup = new java.awt.Menultem("Initilize Group"); 
group.add(joinGroup) ; 
mcSend = new java.awt.MenuItem("Multicast Send"); 
group.add (mcSend) ; 
mainMenuBar.add(group) ; 
becomeMember - new java.awt.Menu("DataSource"); 
a CoRartS =E New java.awt.MenuItem("a CoParts"); 
pecomeMembper adala CoParts):; 
bD UCoParts = new java-awt.Menulwem | becoramts” )7 
becomeMember.add(b CoParts); 
excobarts = new java-.awt-Menudtem("ceCorarts: J 
becomeMember.add(c CoParts); 
mainMenuBar.add(becomeMember) ; 
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menu3 - new java.awt.Menu("Help"); 
mainMenuBar.setHelpMenu (menu3); 

miAbout - new java.awt.MenuItem("About.."); 
menu3.add (miAbout); 

mainMenuBar.add (menu3); 

setMenuBar (mainMenuBar); 

//SS mainMenuBar.move(4,277); 


2051] 


//{{REGISTER LISTENERS 

SymWindow aSymWindow = new SymWindow(); 
this.addWindowListener (aSymWindow) ; 
SymAction lSymAction = new SymAction(); 
miAbout.addActionListener(lSymAction); 
miExit.addActionListener(lSymAction); 
joinGroup.addActionListener(lSymAction); 
sendButton.addActionListener(lSymAction); 
clearTextFieldBttn.addActionListener(lSymAction); 
clearListBttn.addActionListener(lSymAction); 
mcSend.addActionListener(lSymAction); 
SymItem lSymItem - new SymItem(); 
sqlChoices.addItemListener(lSymItem); 

a CoParts.addActionListener(lSymAction); 

Db COParts-addAct tombistener( 1s ymAct1 On) ; 

€ CoPares -aedcAct omirstener (lSmAce1 on) ; 
A, 

) 


public mainFrame (String title) 
{ 
cssc 
setTitle(title); 
) 


public synchronized void show() 
{ 
move (50, 50); 
super.show(); 


) 


skate public vord main(String args 

{ 
mainFrame mainWindow - new mainFrame(); 
mainWindow.show(); 

) 


public void addNotify() 
{ 
// Record the size of the window prior to calling parents 
addNotify: 
Dimension d = getSize(); 


super.addNotify(); 


if (fComponentsAdjusted) 
return; 


// Adjust components according to the insets 

setSize(insets().left + insets().right + d.width, insets().top + 
insets().bottom t d-height):; 

Component components[] = getComponents (); 

for (int i = 0; i < components -leéngen Iti) 


{ 
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BONES = components [1] .cgetLocation(); 
D.tpanslace (insets ()..left, insets () -tep) ; 
components [i] .setLocation(p); 

} 

fComponentsAdjusted = true; 


} 


// Used for addNotify check. 
boolean fComponentsAdjusted = false; 


//{ {DECLARE CONTROLS 
java.awt.FileDialog openFileDialogl; 
java.awt.Panel panell; 
java.awt.Choice requestTypeChoice; 
java.awt.Choice sendToChoice; 
java.awt.Label labell; 
java.awt.Label label2; 
java.awt.Label label3; 
java.awt.TextField messageTextField; 
java.awt.Choice sqlChoices; 
java.awt.Label label4; 
Java.awt.Button sendButton; 
java.awt.Button clearTextFieldBttn; 
java.awt.TextField timeOut; 
java.awt.Label timeOutLable; 
java.awt.Panel panel2; 

java.awt.List resultSetList; 
java.awt.Button clearListBttn; 


URP 


//( (DECLARE MENUS 
java.awt.MenuBar mainMenuBar; 
java.awt.Menu menui; 
java.awt.MenuItem miExit; 
java.awt.Menu group; 
java.awt.MenuItem joinGroup; 
java.awt.MenuItem mcSend; 
java.awt.Menu becomeMember; 
java.awt.MenuItem & CoParts; 
java.awt.MenurtemdPpEPOPOQ Pes, 
Java awtirMentuTtemtegcorarts; 
java.awt.Menu menu3; 
java.awt.MenuItem miAbout; 


x) 


class SymWindow extends java.awt.event.WindowAdapter 


{ 


public void windowClosing(java.awt.event.WindowEvent event) 


( 
Object object = event.getSource(); 
1f (object == mainFrame.this) 
Framel WindowClosing (event); 


j 


void Framel WindowClosing(java.awt.event.WindowEvent event) 


{ 
hide (ti; // hide the Frame 


dispose(); // free the system resources 
System.exit(0); // close the application 
) 


class SymAction implements java.awt.event.ActionListener 
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public void actionPerformed(java.awt.event.ActionEvent event) 
{ 
Object object = event.getSource(); 
if (object == miAbout) 
miAbout Action(event); 
else if (object == miExit) 
miExit_ Action event; 
else if (object == joinGroup) 
joinGroup Action (event); 
else if (object == sendButton) 
sendBütr onka c Ci on(event); 
else if (object == clearTextFieldBttn) 
clearTextFieldBttn Action (event); 
else if (object == clearListBttn) 
ClearListBttn Action(event); 
else if (object == mcSend) 
mcSend Action (event); 
else LE (obert bares) 
aCoParts Acrion(event], 
else if (object == b CoParts) 
bCoParts Action(event); 
else tt A(oby ecos [e Corarts) 
cCoParts Action(event); 


) 


void miAbout Action(java.awt.event.ActionEvent event) 
( 
//{ {CONNECTION 
// Action from About Create and show as modal 
(new AboutDialog(this, true)).show(); 
//)) 
) 


void miExit Action(java.awt.event.ActionEvent event) 
{ 
/ / ( (CONNECTION 
// Action from Exit Create and show as modal 
(new QuitDialog(this, true)).show(); 
77h) 
) 


void miOpen Action(java.awt.event.ActionEvent event) 


{ 
/ / ( (CONNECTION 


// Action from Open... Show the OpenFileDialog 
openFileDialogl.show(); 
28, 


) 


void joinGroup Action(java.awt.event.ActionEvent event) 


{ 
// to do: code goes here. 


/ / {{CONNECTION 
// Create and show as non-modal 
(new joinGroupDlg(this, false)).show(); 
"EA 
) 


void sendButton Action(java.awt.event.ActionEbvent event) 


{ 
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StringBuffer buff = new StringBuffer(); 

String type = requestTypeChoice.getSelectedltem(); 
String sendTo sendToChoice.getSelectedItem(); 
String message - messageTextField.getText(); 

int timer - Integer.parseInt(timeOut.getText() ); 


if (type.equals ("net") ) { 
buff.append (type) ; 


butreabopsnec^ "); 
buff.append (message); 
buff.append(" "); 


) 

else if(type.equals ("db") ) { 
String sql = message.toLowerCase(); 
buff .append (type) ; 
bufft-append( 9); 
buff.append(sendTo); 
pufflappend(" "); 
buff.append (sql); 

) 

else if(type.equals ("response") )( 
buff.append(type); 
buff.append(" "); 
buff.append("net"); 
buff.append(" "); 
buff.append (message); 
buff.append(" "3; 

) 


String request - new String(buff); 
//send the request 
network.sendListenForResponses(this, sendTo, request, timer); 


) 


void clearTextFieldBttn Action(java.awt.event.ActionEvent event) 


( 
// to do: code goes here. 


/ / ( (CONNECTION 
// Clear the text for TextField 
messageTextField.setText (""); 
mon 

) 


public void updateVector(String message) 


{ 
resultVector.addElement (message); 
resultSetList.addItem (message); 


void clearListBttn Action(java.awt.event.ActionEvent event) 


{ 
// to do: code goes here. 


/ / ( (CONNECTION 

A Clear the List 
resultSetList.removeAll(); 
TER 
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public void updateResultList (String message) 


{ 


resultVector.addElement (message); 


//post to response List 
StringTokenizer tok = new StringTokenizer (message, ","); 


if (message == null) { 

resultSetList.addItem("No results were found "); 
Jelse( 

int count = tok.countTokensm5m 

for (int 1x = 1; ix <= count; ix++)( 


String tuple - tok.nextToken(); 
resultSetList.addItem(tuple); 
)//end for 
)//end else 
) 


//for interface 
public boolean mcListen() 


{ 


return true; 


} 


public void setMCListen(boolean flag) {} 


void mcSend Action (java.awt.event.ActionEvent event) 


{ 
// to do: code goes here. 


//{ {CONNECTION 
// Create and show the Frame 
(new mcSendFrame()).show(); 
FY) 

) 


class SymItem implements java.awt.event.ItemListener 


( 


public void itemStateChanged(java.awt.event.ItemEvent event) 


( 
Object object = event.getSource(); 
if (object == sgqlChoices) 
sqlChoices ItemStateChanged (event); 


} 
void sqlChoices ItemStateChanged(java.awt.event.ItemEvent event) 
{ 


// to do: code goes here. 


/ / ( (CONNECTION 


// Set the text for TextField... Get the current item text 
messageTextField.setText(sqlChoices.getSelectedItem()); 
/173) 


) 
void aCOParts Action(jJava. awt. even loa enc Sven) 
{ 

// to do: code goes here. 


//( (CONNECTION 
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// Create and show the Frame with a title... Get the Menultem's 
label 
(nex TStenRrame(a CoParts.getLbabel())).show(); 


177812) 


ANCO APES setEnabled(tfalseë); 
) 


void bCoParts Action(java.awt.event.ActionEvent event) 


{ 


// to do: code goes here. 


/ / ( (CONNECTION 
// Create and show the Frame with a title... Get the Menultem's 
label 
(newfAlistenErament. COPartSs.gethabelt Sho E 
EsGcPurtcesectbnabpled(talsej; 
72/21) 
) 


void cCoParts Action(java.awt.event.ActionEvent event) 


( 
// to do: code goes here. 


J /ALECONNECLION 

// Create and show the Frame with a title... Get the Menultem's 
label 

(new listenFrame(c CoParts.getLabel())).show(); 

SEScPOaPPSUSsctsnagbled(ralse)js 

14449 

) 

) 


SR RR RAN d od ddd ddd d| odda ddd ddd cdd Ag EE 


// End File: mainFrame.java 


f. f kk ke ehe ee he ehe eee ehe eee hee hehe he he he he ee e hehe he hee he e he e e he de ede e e ee eee ee e e e he e e e he de e e e 
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py File: listenFrame.java 

// Purpose: A simple frame, that allows user to initiate the listen 
// thread of the database servers and allows to collect 

// messges received so far. 

// GUI implemented with Visual Cafe 


A UK c E A E E A E ARES 


import java.awt.*; 
import symantec.itools.awt.util.ToolBarPanel; 


public class listenFrame extends Frame implements vectorInt 
{ 
//flag checked by the mcListenerThread, set by netLogic 
boolean mcListen = false; 


public listenFrame () 

{ 
// This code is automatically generated by Visual Cafe when you add 
// components to the visual environment. It instantiates and initializes 
// the components. To modify the code, only use code syntax that matches 
// what Visual Cafe can generate, or Visual Cafe may be unable to back 
// parse your Java file into its visual environment. 
//{{INIT_CONTROLS 
setLayout (null); 
setVisible(false); 


t 
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setSize(insets().left -* insets().rigbt € 400,1nsets().top + 
linsets() bottom + 300); 

toolBarPanell = new symantec.itools.awt.util.ToolBarPanel(); 

toolBarPanell.setLayout(new FlowLayout(FlowLayout.LEFT,0,0)); 

toolBarPanell.setBounds(insets().left + 0,insets().top + 0,395,36); 

add(toolBarPanell); 

privateLine = new java.awt.Button(); 

privateLine.setActionCommand ("button"); 

privateLine.setLabel("Start Listening"); 

privateLine.setBounds(070,95,23)5 

privateLine.setBackground(new Color(12632256)); 

toolBarPanell.add(privateLine) ; 

clearList = new java.awt.Button(); 

clearList.setActionCommand ("button"); 

clearList.setLabel ("Clear List"); 

clearLrst.setBounnds(095)0/657023)5 

clearList.setBackground (new Color(12632256)); 

toolBarPanell.add(clearList); 

hideWindow = new java.awt.Button(); 

hideWindow.setActionCommand ("button"); 

hideWindow.setLabel("Hide Window"); 

hideWindow.setBounds(160,0,87,23); 

hideWindow.setBackground(new Color(16776960)); 

toolBarPanell.add(hideWindow); 

responseList = new Java.awt.List(0, false); 

add (responseList); 

responseList.setBounds(insets().left + 12,insets().top + 96,382,193); 

mcCheckBox = new Java.awt.Checkbox ("mc Listener is Active"); 

mctherkBox SetBoOundsSiinsets() leéfrr 252 Mnsets()EeCp + 36,144,17);: 

add (mcCheckBox) ; 

setTitle("Untitled"); 

FAN 


//((INIT MENUS 
ADO 


A/A (REGISTER LISTENERS 
SymWindow aSymWindow - new SymWindow(); 
this.addWindowListener (aSymWindow); 
SymAction lSymAction = new SymAction(); 
privateLine.addActionListener(lSymAction); 
clearList.addActionListener(lSymAction); 
hideWindow.addActionListener (1SymAction); 
XA 

) 


public listenFrame(String title) 
( 

chisi; 

setTitle(title); 
) 


public synchronized void show() 
{ 

movie (50,750), 

super.show(); 


) 


public void addNotify() 
{ 


// Record the size of the window prior to calling parents addNotify. 
Dimension d = getSize(); 
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super.addNotify(); 


if (fComponentsAdjusted) 
return; 


// Adjust components according to the insets 


setSize(insets().left + insets().right + d.width, insets().top + 
insets().bottom + d.height); 
Component components[] = getComponents(); 


for (int ASUS components. length; i++) 

( 
Point p = components [i].getLocation(); 
p-trans late insets). ette, insets().top) ; 
components [i].setLocation (p); 

) 

fComponentsAdjusted = true; 

) 


// Used for addNotify check. 
boolean fComponentsAdjusted = false; 


//{{DECLARE CONTROLS 
symantec.itools.awt.util.ToolBarPanel toolBarPanell; 
java.awt.Button privateLine; 
java.awt.Button clearList; 
java.awt.Button hideWindow; 
java.awt.List responseList; 
java.awt.Checkbox mcCheckBox; 

i} 


//{ {DECLARE MENUS 
2211) 


class SymWindow extends java.awt.event.WindowAdapter 
( 
public void windowClosing(java.awt.event.WindowEvent event) 
( 
Object object = event.getSource(); 
if (object -- listenFrame.this) 
Framel WindowClosing (event); 


) 


void Framel WindowClosing(java.awt.event.WindowEvent event) 
{ 
Ridel); // hide the Frame 


} 


class SymAction implements java.awt.event.ActionListener 
{ 
public void actionPerformed(java.awt.event.ActionEvent event) 
( 
Object object = event.getSource(); 
if (object == privateLine) 
Beivarchine Action event); 
else if (object == clearlist) 
clédrbist sAction (event); 
else if (object == hideWindow) 
hideWindow Action (event); 


} 


void privateLine Action(java.awt.event.ActionEvent event) 
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Stringrcatasource = this.getTitle()'; 
int listenPort = portNumbers.getListenPort (dataSource) ; 


listenerThread listen = new listenerThread(this, dataSource, 
listenPort); 

//listenerThread listen = new listenerThread(dataSource, listenPort); 

listen.start(); 


/ / ( ( CONNECTION 
// Disable the Button 
privateLine.setEnabled(false); 
//)) 

) 


//vectorInt Implementation 
public void updateVector(String message) 
{ 
//post to response List 
responseList.addItem(message); 


) 


//vectorint Implementation 
public void updateResultList (String message) 
{ 
//do nothing 
) 


//allow mcast listner to check if still in the group 
public boolean mcListen() 


{ 


return mcbrsten; 


) 


//sets the flag, done by netLogic 
public void setMCListen(boolean flag) 
{ 
mcListen = flag; 
if(flag) | 
mcCheckBox.setState(true); 
jelse 
mcCheckBox.setState(false); 


VOld eC hearlist Actiod (java .ewe evene ACETOnAVeN- Even) 


{ 


// to do: code goes here. 


//{ {CONNECTION 
// Clear the List 
responseList.removeAll (); 
25 

) 


void hideWindow Action(java.awt.event.ActionEvent event) 
( 
// to do: code goes here. 


/ / ( (CONNECTION 
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// Move Frame to the back 


toBack(): 
IDO 


void closeButton Action(java.awt.event.ActionEvent event) 


( 
/* 


// to do: code goes here. 


String myName - this.getTitle(); 
if (myName-equals (“a CoParts") )( 


melnWindow. a CoParts.setEnabled rue; 


jelse if(myName.equals("b CoParts") )( 


mainWindow.b CoParts.setEnabled(true); 


)else if (myName.equals("c CoParts") )4 


) 
A 


} 
} 


mainWindow.c CoParts.setEnabled(true); 


JA RECAER RR EA A A EA K occi KR eoe E OK AENA OREOGOKCKDEON ORO OO oe e 


7- End File: 


listenFrame.java 


HS eroe A CA NA A A O A AA E I K OR E KR eoe 


REDE k XO Kok CR AA E A CO C ERR ERR A II RAR e Sek 


// File: mcSendFrame.java 

// Purpose: A simple frame, that allows user to create and send 

PP multicast requests based on the communication protocol 
AA we implemented 

n GUI implemented with Visual Cafe 


MOX UE ER RAR RE ANR ER ES A E A AA OK ek e 


import java.awt. 


e 
r 


Enport java.util.*; 


import symantec. 


itools.awt.shape.HorizontalLine; 


public class mcSendFrame extends Frame implements vectorInt 


{ 


Vector resultVector = new Vector): 


networkUtil 


networks" new netwob dtr ui. 


public mcSendFrame () 


{ 


insets() .bottom 


// This code is automatically generated by Visual Cafe when you 
// add components to the visual environment. It instantiates 

// and initializes the components. To modify the code, only use 
// code syntax that matches what Visual Cafe can generate, or 
// Visual Cafe may be unable to back parse your Java file into 
// its visual environment. 

//1(INIT CONTROLS 

setLayout (nu11); 

setVisible(false); 

Ssetsize (insets () -lett)-sincets ().2tome + 500,i1nsets().top + 
PRD, 

panell - new java.awt.Panel(); 

panell.setLayout (null); 

panell.setBounds(insets().left * l2,i1nsets().top + 12,481,168); 
add (panell); 

requestTypeChoice = new java.awt.Choice(); 
requestTypeChoice.addItem("db"); 
requestTypeChoice.addItem("net"); 
requestTypeChoice.addItem("response"); 
panell.add(requestTypeChoice); 
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1) T 


char 2010 > 


"brake pad'"); 


"tani 22) E 


requestTypeChoice.setBounds (96,0,118,24); 


labell = new java.awt.Label ("Request Type:"); 
labell.setBounds(12,0,108,24); 

panell.add(labell); 

label3 = new java.awt.Label ("Message or Request"); 
label3.setBounds (264,60,163,16); 
panell.add(label3); 

messageTextField = new java.awt.TextField(); 


messageTextField.setBounds (216, 84,264,25); 


panell. 
sendButton = 
sendButton. 
sendButton. 
sendButton. 
sendButton. 
panell. 
clearTextFieldBttn = 
clearTextFieldBttn. 
clearTextFieldBttn. 
clearTextFieldBttn. 
clearTextFieldBttn. 
panell. 
mciP = 


add (messageTextField); 

new java.awt.Button(); 
setActionCommand ("button"); 
setLabel("Send"); 
setBounds 395 1207 80,25); 
setBackground(new Color(12632256)); 
add (sendButton) ; 

new java.awt.Button(); 
setActionCommand ("button"); 
setLabel("Clear"); 
setBounds (240, 120,80,25) ; 
setBackground (new Color (12632256)); 
add (clearTextFieldBttn); 

new java.awt.TextField(); 


mcrP.setText("230.0.0.1"); 
mcIP.setBounds(108,36,72,19); 


panell 
mcPort 
mcPort 


mcPort. 
.add (mcPort) ; 


panell 
label2 


label2. 
. add (label2); 


panell 
label4 
label4 
panell 


add (mcIP); 


= new java.awt.TextField(); 


.setText ("4446"); 


setBounds(108,72,48,20); 


= new java.awt.Label ("Group 1P:"); 
setBounds (12,36,60,18); 


= new Java.awt.Label ("Group Port:"); 


.setBounds (12,72,72,20); 
.add(label4); 
acksTextField = 


new java.awt.TextField(); 


acksTextField.setText("1"); 
acksTextField.setBounds(108,108,42,19); 


panell. 


label5 


label5. 
panell. 
sqlChoices = 
sqlChoices 


sqlChoices. 
sqlChoices. 


sqlChoices 
sqlChoices 


sqlChoices 
sqlChoices. 


TEJA 


) cateb 
panell. 


add(acksTextField); 

= new java.awt.Label("# of Replies:"); 

setBounds (12; 1087707191; 

add (label15); 

new java.awt.Choice(); 

.addItem("INSERT INTO parts VALUES(12, 'trailer', 50, 
'mu f f les E 

supplier 


addItem("DELETE FROM parts WHERE part = 
addItem("CREATE TABLE invoices(id int, 


.addItem("SELECT * FROM parts"); 
.addItem("UPDATE parts SET quantity = 10 WHERE part = 
.addItem("DROP TABLE testTable"); 

addItem("SELECT part FROM parts WHERE part - 


sglChoices.select(-1); 
(IllegalArgumentException e) { } 
add(sqlChoices); 


sglChoices.setBounds (228,24,240,24); 


timeOut 


= new java.awt.TextField(); 


timeOut.setText ("15000") ; 
timeOut.setBounds(108,144,48,19); 
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panell.add(timeOut); 

label6 = new jJava.awt.Label ("Set Timer (ms):"); 

label6.setBounds(12,144,89,17); 

panell.add(label6); 

label7 = new java.awt.Label ("Sample SQL"); 

labpel/.setBounds(276,0,131,16); 

panell.add(label?7); 

horizontalLinel - new 
symantec.itools.awt.shape.HorizontalLine(); 

horizontallinel.setBounds (-12,179,492,1); 

panell.add(horizontalLinel); 

resultSetList = new java.awt.List(0,false); 

add(resultSetList); 

resultSetList.setBounds(insets().left + 12,insets().top + 
204,466,165); 

clearListBttn = new java.awt.Button(); 

ClearListBttn.setActionCommand ("button"); 

clearListBttn.setlabel ("Clear ResultSet"); 

elearkistBttin.setBounds (imsets().lert + 252,i1nSets().top + 
384,96,28); 

clearListBttn.setBackground(new Color(12632256)); 

add(clearListBttn); 

closeButton = new java.awt.Button(); 

closeButton.setActionCommand("button"); 

closeButton.setLabel ("Close"); 

closeButton.setBounds(insets().left + 132,insets().top + 
554,71, 290% 

closeButton.setBackground (new Color(16711680)); 

add (closeButton); 

setTitle ("Multicast Request"); 

22003) 


//((INIT MENUS 
77204) 


//((REGISTER LISTENERS 
SymWindow aSymWindow - new SymWindow(); 
this.addWindowListener (aSymWindow); 
SymAction lSymAction = new SymAction(); 
clearListBttn.addActionListener(lSymAction); 
closeButton.addActionListener(lSymAction); 
ClearTextFieldBttn.addActionListener(lSymAction); 
sendButton.addActionListener(lSymAction); 
SymlItem lSymitem - new SymItem(); 
SqlChoices.addItemListener(lSymItem); 
703 

) 


public mcSendFrame(String title) 


( 
tnis) 
setTitle(title); 
) 


public synchronized void show() 


( 
move(50, 50); 
super.show(); 


) 


public void addNotify() 
( 
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// Record the size of the window prior to calling parents 
addNotify. 
Dimension d = getSize(); 


super.addNotify(); 


if (fComponentsAdjusted) 
return; 


// Adjust components according to the insets 
setSize(insets().left + insets().right + d.width, insets().top 
Flinsets () .bottom + d'heichc): 

Component components Í[] = getComponents (); 

for (int 1 = 0; 1 < components length; 17) 

{ 
Point p - components[il.getLocation(); 
p.transJate(insets()-.left, ansets(i) top): 
components[i].setLocation(p): 

} 

fComponentsAdjusted 


true; 


} 


// Used for addNotify check. 
boolean fComponentsAdjusted = false; 


//{{DECLARE CONTROLS 

java.awt.Panel panell; 
java.awt.Choice requestTypeChoice; 
java.awt.Label labell; 
java.awt.Label label3; 
Java.awt.TextField messageTextField; 
java.awt.Button sendButton; 
java.awt.Button clearTextFieldBttn; 
java.awt.TextField mcIP; 
java.awt.TextField mcPort; 
java.awt.Label label2; 
java.awt.Label label4; 
java.awt.TextField acksTextField; 
java.awt.Label label5; 
java.awt.Choice sqlChoices; 
java.awt.TextField timeOut; 
java.awt.Label label6; 
java.awt.Label label); 
symantec.itools.awt.shape.HorizontalLine horizontalLinel; 
java.awt.List resultSetList; 
jJava.awt.Button clearListBttn; 
java.awt.Button closeButton; 


177) 


//{ {DECLARE MENUS 
22 


class SymWindow extends java.awt.event.WindowAdapter 


{ 


public void windowClosing(java.awt.event.WindowEvent event) 


i 
Object object = event.getSource(); 
if (object == mcSendFrame.this) 
Framel WindowClosing (event); 


) 


void Framel WindowClosing(java.awt.event.WindowEvent event) 
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{ 
hide (); // nide the Frame 


} 


Class SymAction implements java.awt.event.ActionListener 


{ 


public void actionPerformed(java.awt.event.ActionEvent event) 


{ 


Object object = event.getSource(); 


if (object == clearListBttn) 
ClearlistBttn Aeceten (evens es, 

else if (object == closeButton) 
closeButton Action(event); 

else if (object == clearTextFieldBttn) 
cleartextFieldBttncActión(event):; 

else 1f (object == sendButton) 


sendButton Action (event); 


} 


void clearListBttn Action(java.awt.event.ActionEvent event) 


{ 


// to do: code goes here. 


/ / ( (CONNECTION 
// Clear the List 
resultSetList.removeAll(); 
EA 

} 


void cïoseButtonmzction(javarewreteévéemtt Act ioneEventWeêvéent) 


( 


// to do: code goes here. 


//{ {CONNECTION 
// Hide the Frame 
setVisible(false); 
LIIT 

} 


void clearTextFieldBttn Action(java.awt.event.ActionEvent event) 


( 
// to do: code goes here. 


// ( (CONNECTION 
// Clear the text for TextField 
messageTextField.setText(""); 
iii 

} 


void sendButton Action(java.awt.event.ActionEvent event) 


{ 
Stringpunrer burt = new StringBurter(); 


String type = requestTypeChoice.getSelectedItem(); 
String @rouplP = mclP.getText(); 

ine groupPort = Integer.parselnt(mePort -qetText() ); 

int acks - Integer.parseInt(acksTextField.getText() ); 


String message - messageTextField.getText(); 


if (type.equals ("net") ) { 
buff.append (type) ; 
Suri. aprenda "); 
buff .append (message); 
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buff.append(" "); 

) 

else if(type.equals("db"))( 
String sql = message.toLowerCase(); 
buff.append(type); 
puff append all 
buff.append (sql); 

} 

else if (type.equals ("response") )( 
buff .append (type) ; 
buff.append(" "); 
buff.append (message); 
buff.append(" "5; 

) 


String request = new String (buff); 
int timer - Integer.parseInt(timeOut.getText() j; 


//send the request 
network.mcSendListenForResponses(this, groupIP, groupPort, acks, 
timer, request); 


) 


public void updateVector(String message) 
( 
resultVector.addElement (message); 
resultSetList.addltem(message); 


} 


private synchronized void updateResultSet (String message) 


{ 


resultVector.addElement (message); 


//post to response List 
StringTokenizer tok = new StringTokenizer(message, ","); 
if (message -- null)( 
resultSetList.addItem("No results were found "); 
jelse{ 
iipeecoune = tok.countrokens(); 
form INC IX = 13 ix <=-count;)ix+t) { 
String tuple = tek nexciokent); 
resultSetList.addItem(tuple); 
}//end for 
}//end else 


} 


public void updateResultList (String message) 


{ 
updateResultSet (message); 


}//end function 


//for intertace 
public boolean mcListen() 


( 
return true; 


) 


public void setMCListen(boolean flag) {} 
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class SymItem implements java.awt.event.ItemListener 


{ 


public void itemStateChanged(java.awt.event.ItemEvent event) 


{ 
Object object = event.getSource(); 
if (object == sqlChoices) 
sqiChoices ItemStateChanged (event) ; 


} 
void sqlChoices ItemStateChanged(java.awt.event.ItemEvent event) 
{ 

// to do: code goes here. 


/ / { {CONNECTION 


Seu the text for TextField... Get the curren item text 


messageTextField.setText (sqlChoices.getSelectedItem()); 
//}} 
} 


}//end class 
E E ER RAEE ERA ERA EEX EERE EEX REESE eoe ok coro icc AE 


// End File: mSendFrame.java 
IS A A ok oe ke e ee e e e e e ee e e e ehe echo t oe 


PP FARARERR AEREA RENA AER ERA AARER ERRE RAR ARA RARA ee kc eoe kk e e de 


// File: joinGroupDlg.java 

// Purpose: A dialog object, that allows database servers to join 
L to thje specified multicast group (based on the 

777 IP address and port number) 

7 GUI implemented with Visual Cafe 


PERRA RARA AAA AREA RENA RARA EAN AMARA ERA LARA RRA e e hee ee ke eoe he hehe he hehe 3a <e 
IMport ave. ant "7 
import java.util. *; //for vector 


public class joinGroupDlg extends Dialog implements vectorInt 
i networkUtil network = new networkUtil(); 

Vector resultVector = new Vector(); 

public joinGroupDlg (Frame parent, boolean modal) 

( 


super (parent, modal); 


// This code is automatically generated by Visual Cafe when you add 


// components to the visual environment. It instantiates and initializes 
// the components. To modify the code, only use code syntax that matches 
// what Visual Cafe can generate, or Visual Cafe may be unable to back 


// parse your Java file into its visual environment. 

//((INIT CONTROLS 

setLayout (null); 

setVisible (false); 

setSize(insets().left + insets().right + 451,insets().top + 
insets().bottom + 270); 

panell = new java.awt.Panel(); 

panell.setLayout (null); 

panell setBounds(insets().left + 127insets():top + 12,408,800); 

add (panell); 

labell - new java.awt.Label("Group IP:"); 

Tabelil?serBounds(12,12,103,22); 
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panell.add(labell); 

mcPort - new java.awt.TextField(); 
mcPort.setText("4446"); 
ncPort.setBounds(132,48,48,20)& 

panell.add(mcPort); 

label2 = new java.awt.Label ("Group Port #:"); 
label2.setBounds (0,48,110,22); 

panell.add(label2); 

recipiant - new java.awt.TextField(); 

recipiant .setBounds (252,12, 1356, 20); 
panell.add(recipiant); 

joinGroupButton - new java.awt.Button(); 
joinGroupButton.setActionCommand ("button"); 
joinGroupButton.setLabel("Join Group"); 
joinGroupButton.setBounds (276,48,95,25); 
JoinGroupButton.setBackground (new Color(12632256)); 
panell.add(joinGroupButton); 

mcIP - new java.awt.TextField(); 

mclP.setText| 290504071 5; 
mcIP.setBounds(120,/12,72,19); 

panell.addimclP); 

panel2 - new java.awt.Panel(); 

panel2.setLayout (null); 
panel2.setBounds(insets().left + 12,insets().top + 108,204,132); 
add (panel2); 

label3 = new java.awt.Label ("Responses:"); 
label3.setBounds(48,0,72,12); 

panel2.add (label3); 

responseList = new java.awt.List(0, false); 
panel2.add(responseList); 

responseList.setBounds (0,24,180, 84); 

closeButton = new java.awt.Button(); 
closeButton.setActionCommand ("button") ; 
closeButton.setLabel ("Close"); 
closeButton.setBounds (insets().left + 156,insets().top + 240,71,29); 
closeButton.setBackground (new Color (12632256)); 

add (closeButton); 

leaveGroupButton - new java.awt.Button(); 
leaveGroupButton.setActionCommand ("button"); 
leaveGroupButton.setLabel("Leave Group"); 
leaveGroupButton.setBounds(insets().left + 288,insets().top + 108,95,25); 
leaveGroupButton.setBackground (new Color(16711680)); 
add (leaveGroupButton); 

setTitle("Join Group"); 

£235) 


//{{REGISTER LISTENERS 
SymWindow aSymWindow - new SymWindow(); 
this.addWindowListener(aSymWindow); 
SymAction lSymAction - new SymAction(); 
joinGroupButton.addActionListener(lSymAction); 
closeButton.addActionListener(lSymAction); 
leaveGroupButton.addActionListener (1SymAction) ; 

LITI 

} 


public void 38d4N6t1t7 0 

( 
// Record the size of the window prior to calling parents addNotify. 
Dimension d = getSize(); 


super.addNotify(); 
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if (fComponentsAdjusted) 
return; 


// Adjust components according to the insets 
setSize(insets().left + insets().right + d.width, 


insets().bottom *2dohewght):; 


Component components[] = getComponents () ; 
for, (int 1 — (PRÉ Omponents.length; i++) 
{ 

Point p = components [i].getLocation(); 


p-tramslate (insets ()-left, insets ().top)-; 
components [i] .setLocation(p) ; 


} 


fComponentsAdjusted = true; 


} 


// Used for addNotify check. 
boolean fComponentsAdjusted = false; 


insets().top + 


public joinGroupDlg(Frame parent, String title, boolean modal) 


{ 


this (parent, modal); 
setlitlée title) 


} 


public synchronized void show() 


( 


Rectangle bounds = getParent ().bounds (); 
Rectangle abounds = bounds (); 


move (bounds.x + 
bounds ver 


super.show(); 


) 


//((DECLARE CONTROLS 


java. 
java. 
java. 
java. 
java. 
java. 
java. 
java. 
java. 
java. 
java. 
java. 


Za 


class SymWindow extends java.awt.event.WindowAdapter 


( 


awt. 
.Label labell; 
awer 
awt. 
.TextField recipiant; 
.Button joinGroupButton; 
.TextField mcIP; 


awt 


awt 
awt 
awt 


awt. 
awt. 
awt. 
.Button closeButton; 

.Button leaveGroupButton; 


awt 
awt 


Panel panell; 


TextField mcPort; 
Label label2; 


Panel panel2; 
Label label3; 
List responseList; 


(bounds.width - abounds.width)/ 2, 
(bounds.height - abounds.height)/2); 


public void windowClosing(java.awt.event.WindowEvent event) 


{ 


Object object - event.getSource(); 


ER 


) 


(object == joinGroupDlg.this) 
Dialogl WindowClosing (event); 


void Dialogl WindowClosing(java.awt.event.WindowEvent event) 
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{ 
} 


hide 


class SymAction implements java.awt.event.ActionListener 


( 


) 


public void actionPerformed(java.awt.event.ActionEvent event) 
{ 
Object object - event.getSource(); 
if (object -- joinGroupButton) 
joinGroupButton Action(event); 
else if (object == closeButton) 
closeButton Action(event); 
else if (object -- leaveGroupButton) 
leaveGroupButton Action(event); 


void leaveGroupButton Action(java.awt.event.ActionEvent event) 


( 


) 


String IP - mcIP.getText(); 

String mailTo -» recipiant.getText(); 

String message = leaveGroup(IP); 
network.sendListenForResponses(this, mailTo, message, 15000); 


// Clear the text for TextField 
recipiant.setText (""); 


void joinGroupButton Action(java.awt.event.ActionEvent event) 


( 


) 


// to do: code goes here. 

//get the mcIP 

Sering bean 230 0.0..." 

IP = mcIP.getText(); 

int port = 4446; 

port = Integer.parseInt(mcPort.getText() ); 
String marlio- = null; 

mallTo = reciplant.getText(); 

String message = null; 

message! = joinGroup(1P, port); 


network.sendListenForResponses(this, mailTo, message, 15000); 


// Clear the texto TextField 
recipiant.setText(""); 


public String JoinGroup (oS cring da inte Gp) 


{ 


//createm message 

StringBuffer mBuff = new StringBuffer( "net join" ); 

mBuff = mBuff.append( " " ); 

mBuff - mBuff.append(da); //230.0.0.1 

mBuff = mBuff.appenal( ">; 
( 
( 


Il 


mBuff - mBuff.append( dp); //4446 
mBuff - mBuff.append( " " ); 
String message - new String( mBuff ); 


return message; 
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} 


public String leaveGroup (String da) 
( 
//createm message 
StringBuffer mBuff = new StringBuffer( "net leave" ); 


mBuff = mBuff.append( " " ); 
mBuff = mBuff.append(da); //230.0.0.1 
mBuff - mBuff.append( " " ); 


String message - new String( mBuff ); 


return message; 


public void updateVector(String message) 


{ 


resultVector.addElement (message); 


//post to response List 
responseList.addItem(message); 


) 


public void updateResultList(String message) 
{ 

//do nothing 
} 


//for interface 
public boolean mcListen() 
( 


return true; 


) 
public void setMCListen (boolean flag) {} 


void closeButton_ Action (java.awt.event.ActionEvent event) 


{ 
// to do: code goes here. 


//{ {CONNECTION 
// Hide the Dialog 
setVisible (false); 
77212) 
} 
}//end class 


[[*tk*k*k*k*k k k k k k x k k x k k x k x x k k x xk k k x k k x k k k x k x kx k x k x k x x k x kx x x k x x k e x x x x x x x *x x x x * 


A End File: joinGroupDlg.java 


[[*tkk*k*k k k k k k k k k k x k k k x k k k k k k k % k k k x x e x %« k k k % x k k x k k k x K K % % * % « K K * K * * e K H e e x x 


f | Fk ke he ehe ehe ehe KKK k KK K k K K K H Kk K K K KH K Kk K k k K Kk K K Kk k K K K K H KKK Kk XK k K K K k K k K K K k * k * * 


m File: vectorInt.java 
// Purpose: The interface between logic objects and the GUI 
17 that displays the results 


[[*kk*k*k*k*k k k k k k k k k kx k x k k kx k k k k xk k k k k k k k k xk k k k k x k xk k k x k k k k k k x k k x x x k kx x e * x e k x x ke 


import java:util2*;7 //for vecor 


public interface vectorInt 


( 
//sends a message to mother 
public abstract void updateVector(String message); 
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} 


//tells mom its a resultSet 
public abstract void updateResultList (String message); 


// checks mothers mcListen flag, used by mcListenThread 
J to evaluate if still in" group or not 

public abstract boolean mcListen(); 

public abstract void setMCListen(boolean flag); 


E A E dd d dda 


Le 


End File: vectorInt.java 


f f| * * kk ehe EKKEREKERERKEKEEKEEEKEKREKKEKKKKKKKKEKKEK KKK KKK KKK KKK Kk Kk eK KK 


f | kc hehehe he e ehe de he e e de e e e e dece ede e ehe RRA RRA RRA RRA RRA AAA 


A 
// 
(ay 
Lh 
Lr 
/ / 


File: listenerThread. java 

Purpose: Implementation of a generic listener thread for database. 
server objects. This thread is spawned when the database 
objects are created and listens on a specified port. 
This listener thread spawns a message handler thread and 
sends the message to it. 


PERERA ERA oec coe oic ER cci CK RARER RK EA EK EX 


import java.io.*; 
import java.net.*; 
import Java ULT: 


public class listenerThread extends Thread( 


static int threadNumber = 1; //threadID 

protected InetAddress address = null; //who sent me the packet 
protected DatagramPacket inPacket = null; //response packets 

int listenPort = 0; 

int sendPort = 0; 

DatagramSocket listenerSocket = null; //socket to listen 


String name = null; 
Vectorlne mother = sulle 
boolean haveMom = false; 


private static final boolean debug = true; 


f J| KC he e hehe che e e e ehe he e he e he he he he de e e ehe e e e he e e ehe e he e e e e ehe e e e he he e eek 


// Function: clientListenThread(int listenPort) 
// Purpose: Constructor, user specifies port to listent to 
17 for a message 
f [| K K E K m de he K de de de RRA RARA de e de de RRA RRA RARA RAR 
public listenerThread(String name, int listenPort) 
( 
super (name); 
System.out.println("Created listenerThread " + name + " ] " + 


lrstenPort): 


this.listenPort = listenPort; 
ay 
listenerSocket = new DatagramSocket (listenPort) ; 
}catch (SocketException e) { 
System.err.println(”"Client Thread Error ” + e); 
}catch(IOException e){ 
System.err.println("Client Thread Error ” + e); 


} 


|Z7Zemdueconstructor 
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PEER AEREA RARA RRA ARA RRA RR RARE RA AAA REA RAR 


/Mrunction cclientListenThread(int listenPort) 
// Purpose; Constructor, user specifies port to listent to 
/ / for a message 
f| f| Foe hee eee ee e de ee d K kek kkk k kk ae oe e e dece tee ee ee ee ee eee ek d K d d eek 
public listenerThread(vectorInt mother, String name, int listenPort) 
{ 
super (name); 
this.mother = mother; 
this.name = name; 
this.haveMom = true; 


System.out.println("Created listenerThread " + name + " | " + listenPort 


+ " mother " + mother); 
this.listenPort = listenPort; 
try{ 
listenerSocket - new DatagramSocket(listenPort); 
}catch (SocketException e) { 
System-evrepeintini( Client Thread Error ~ + e); 
}catch (IOException e) { 
SVStem-err-println( Client Thread Errore e); 
) 


}//end constructor 


f f| Ne ehe ke e ke de ehe he ee ee eee de ede eee ehe e e ke dee hehe e eee he ce he e he e e e ke ke 


7 EUnet ion. void run} 
// Purpose: Starts the listener thread 
] | Kx 3 * H e e e ee e e de dc e de e de e e e de de de de de de de dc de de de de de de de de de de dc de de de 3 de de K he ke ke ke kee 
public void sunt) 
( 
//forever loop 
while(true)( 
ET 
//creat a inPacket for incoming messages 
byte [] buff = new byte[512]; 
inPacket = new DatagramPacket (buff, buff.length); 


//wait to recieve a message 
listenerSocket.receive(inPacket); 


System.out.println(this.getName() + " listnerThread has recived a 


packet"); 


if (haveMom) { 


System.out.println("creating a mother message HandlerThread"); 
messageHandlerThread handler = new messageHandlerThread (mother, 


inPacket, this.getName() ); 
handler.start(); 
jelse { 
System.out.println("creating a non--mother message 
HandlerThread"); 
messageHandlerThread handler = new 
messageHandlerThread(inPacket, this.getName()); 
handler.start(); 
} 


}catch (IOException e) { 
System. out.println (e); 
}//end try 
}//end while 
}//end run 


}//end class 


J [k k *k 3 * 3k Kk k K K k * ke k * k k k k ke de ke de k ke ke ke k k k k k k k k k k k k k k k d k k k k k k e ke ke tee ke 
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"d 


End File: listenerThread.java 


[ [k *k * 3% * H % *% e kk ee * * e ke e e I K H ke cce ke ck e k K k *k d k k K Kk *k Kk ck e ck e ck e K * 3% * K ke k ck ce k k k k k K * 3% 
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Lá 
2 


File: mcListenerThread.java 

Purpose: When a client joins a multicast group, this 
(mcListenerThread)thread is spawned to monitor and 
display incoming messages. Each object in the group has 
one multicast listener and one private listener threrad. 


JJFEREREREEREREERRREERRE EEE EEE KE KE HR HRK ee de de e ce dece e ce eoe eoe eee echec ek ehe ee kk 


import java.io.-*; 
import java.net.*; 
Import javasutile 


public class mcListenerThread extends Thread( 


boolean inGroup = true; 


protected MulticastSocket socket = null; 
protected InetAddress address = null; 
protected DatagramPacket packet = null; 


static int threadNumber = l; 
vectorInt mother = null; 
boolean haveMom = false; 


public mcListenerThread(String groupID, int groupSocket, String owner) 
{ 
this.setName (owner) ; 
try{ 
//join the Multicast group 
socket = new MulticastSocket (groupSocket) ; 
address = InetAddress.getByName (groupID) ; 
socket .joinGroup (address) ; 


}catch(UnknownHostException e) { 
Svstem.err.printin("Client Thread Error re), 
}catch (IOException e) { 
System.err.println("Client Thread Error " 4 e); 
) 
|"oendeconstructor 


public mcListenerThread(vectorInt mother, String groupID, int groupSocket, 


String owner) 


( 
this.setName(owner); 
this.mother = mother; 
this.haveMom = true; 


try{ 


//join the Multicast group 
socket = new MulticastSocket (groupSocket) ; 
address - InetAddress.getByName (groupID); 
socket.joinGroup (address) ; 


}catch (UnknownHostException e) { 
System.err.printin("Client Thread Error " + e); 
}catch (IOException e) { 
System.err.println("Client Thread Error " + e); 
) 
)//end constructor 
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//start thread 
publie void Kun) 
{ 
if (haveMom) { 
System.out.println("mcListenerThread with mom “ + mother +" " +" 


Status " + mother.mcListen()); 
while( mother.mcListen() ) { 


byte [] buff = new byte[512]; 
packet = new DatagramPacket (buff, buff.length); 


Ery{ 
//recieve a message 
Socket.receive(packet); 


//pass root name 

StringTokenizer tok = new StringTokenizer(this.getName()); 

String rootName = tok.nextToken(); 

//spawn a request handler thread 

messageHandlerThread handler = new messageHandlerThread (mother, 
packet, rootName) ; 

handler.start (); 

System.out.println("spawning a messageHandlerThread for " + 


mother); 


}catch (IOException e) { 
System-out.printiní(e); 
System.exit(-1); 

) 

)//end while 


rey 
socket.leaveGroup (address) ; 
socket.close(); 
}catch(IOException e) { 
System. err printini "Client Thread Error " + e); 


} 
}//end if 


//for the orphans 
else{ 
//forever loop 
while(inGroup) { 


//creat a inPacket for incoming messages 
byte [] buff = new byte[256]; 
packet = new DatagramPacket (buff, buff.length); 


tryl 
//recieve a message 
socket.receive (packet); 


//pass root name 
StringTokenizer tok - new StringTokenizer(this.getName()); 
String rootName = tok.nextToken(); 
//spawn a request handler thread 
if (haveMom) { 
messageHandlerThread handler = new 
messageHandlerThread (mother, packet, rootName); 
handler.start(); 
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mother); 


System.out.println("spawning a messageHandlerThread for " + 


jelse{ 
messageHandlerThread handler = new 


messageHandlerThread (packet, rootName) ; 


handler.start(); 
} 


)catch (TOExcepticn ei 
System our prin (ee 
System exit > 

} 

}//end while 


tryl 
socket.leaveGroup(address); 
socket.close(); 
}catch (IOException e) { 
System.err.println("Client Thread Error " + e); 


) 


)//end else 
}//end run 


public void leaveGroup () 


{ 


inGroup = false; 


} 


}//end class 


Ll A k k k k k k k k k k k k k k k AA % *% % * * 


77 End E le: mcListenerThread.java 


f f[ Foe e e e e ee ee ee e e e e ce dece e ke e he cde ede ee cde ede ese e e dece e e esce eoe oe e e e e e ke ke kk kk ke ke ek e e € e 


y NER RE A A AA A Ke 


// File: 


messageHandlerThread.java 


// Purpose: When a process, either a listenerThread or mcListenerThread 


recieves à message it spawns off a messageHandlerThread which 
invokes the appropriate business logic to process the 
request 


f f 5 Roe de dee oe dede e eode ode * dece e k k k k he Kk d k ï k k eoe de ehe dede *% % H Kk % K” d % d K dH H % H k H d eoe dee eoe ek e % e n € 


inpor- java.io: ~”; 

import java.net.*; 
import Java utili; 
import Tava. sSql2*; 


public class messageHandlerThread extends Thread 


( 


static int. melb. =.L:; 


private static final boolean debug = true;  //for debugging 


DatagramPacket myPacket = null; 


InetAddress senderAddress 


Dip 


int SerdecPore = 0? 


String threadName = null; 


vectorInt mother - null; 
boolean haveMom = false; 
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//keep track of mcgroups thread has joined 
Vector mcVector = null; 

String message = “"; 

//declare a dbServer 

COUE T dbServer new dbUtil(); 
networkUtil network = new networkUtil(); 


l 


f /* x a e a oie kc ke e e e e e khe ede eee ee hee e ee ee EKA Ee © 


// Function:messageHandlerThread(DatagramPacket inPacket, int threadNumber) 
// Purpose: Thread constructor, takes the datagram packet and it's assigned 
7 thread number 
[f | K H * *H H 3 d d de de dc d 3% de He d Se de de de de He de de de de d he ee We de de de Se de ede de de de de He de de He de de me Ke de m d * H eoe 
public messageHandlerThread(DatagramPacket inPacket, String owner) 
{ 

this.setName (owner); 

this.threadName = owner; 

//get the request message 

message = new String(inPacket.getData() ); 


//get the address and port of the requestor 
senderAddress - inPacket.getAddress(); 
senderPort = inPacket.getPort(); 


)//end constructor 


JU Ek kk kho oec ke ke eoe hoe hk ehe e e e e eoe eee e e e he e Wee ee e e e a 


// Function: messageHandlerThread(DatagramPacket inPacket, int threadNumber) 
// Purpose: Thread constructor, takes the datagram packet and it's assigned 
5 thread number 
f. [ K Kk * *k hee he 3 d H *« de ede d d de dece e H H d d d K d K H K d e de K d d K K d dœ e e e ehe de de dœ d de e dœ dœ dœ e e ke 
public messageHandlerThread(vectorInt mother, DatagramPacket inPacket, 
String owner) 

{ 

this.setName (owner) ; 

this.threadName = owner; 

this.mother = mother; 

this.haveMom = true; 


//get the request message 
message = new String(inPacket.getData() ); 


//get the address and port of the requestor 
senderAddress - inPacket.getAddress(); 
senderPort = inPacket.getPort(); 


ny) Jena constructor 


[JARA ARO RO RR RR ROO RO Se he de de de Ke e ROO OR He de de ke de de de de de de de de de Ke de de Ke de de de d e ee eek 


// EuRneedondu Vod run() 

// Purpose: Starts the thread, called by start(); 

( [| Fk * H 3% e e e e K * H d de e he e K de de d de He e K de de de de de de K de K de e e e de de de de de Ke de Ke d de e e de d e ek 
public vord run) 


{ 


//parse the message recieved 

StringTokenizer tok = new StringTokenizer (message); 
//who needs to process this message 

String logicModule = tok.nextToken |); 


//reformat the rest of the message 
String restOfMessage - restOfMessage(tok); 
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//evaluate first token to determine which logicModule to call and pass 
// that module the rest of the message 
if (logicModule.equals( "net") )( 
if (haveMom) ( 
networkLogic nl = new networkLogic (mother, threadName, 
restOfMessage, senderAddress, senderPort); 
nl.executeRequest(); 
jelse ( 
networkLogic nl - new networkLogic(threadName, restOfMessage, 
senderAddress, senderPort); 
nl.executeRequest(); 
) 
) 
else if(logicModule.equals( "db") ){ 
1f (haveMom) { 
dbLogic dl = new dbLogic(mother, threadName, restOfMessage, 
senderAddress, senderPort); 
dl.executeRequest (); 
}else{ 
dbLogic dl = new dbLogic(threadName, restOfMessage, senderAddress, 
senderPort); 
dl.executeRequest(); 
) 
) 
else if (logicModule.equals( "response") ) { 
if (haveMom) { 
responseLogic rl = new responseLogic(mother, threadName, 
restOfMessage, senderAddress, senderPort); 
rl.executeRequest(); 
jelsel 
responseLogic rl = new responseLogic(threadName, restOfMessage, 
senderAddress, senderPort); 
rl.executeRequest(); 
) 


} 


else( 
//dont process this request 
System.out.println("Message Handler cannot process this request ..."); 


if (haveMom) ( 
mother.updateVector ("Message Handler cannot process this request”); 
} 


enana 
)//end run 
private String restOfMessage (StringTokenizer tok) 
StringBuffer butt = new StringBuffer( ); 


//get the rest of the request 


while( tok.hasMoreTokens() )( 
buff - buff.append( tok.nextToken() ); //appends the sql statement 
buff - buff.append( " " ); 


) 
String result = new String! butte, 


return result; 


} 


}//end class 
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Mc EE EE CR FA e esee 


Py Eng rile: messageHandlerThread.java 


PE RTE A RR A A A ee ee ee eR eR Ke 


[ [RRR RRR KR KKK KKK KKK kkk kkk Kk kk kkk kkk kkk kkk kkkkkkkkekkkaek kkk kk kkk & ke 


M Tile: dbLogic.java 

// Purpose: This class contains the business logic to handle the 
// database requests based on the given priviliges of the 
4 f database server. 


[/*)*k#*kk*k kkk k k x k k kk k k k x x k k k x k k k k k k k k x kx k k kK x x x xx k x k x x k k k k k k x x x x x w x k x x x 3 * * 


import java.net.*; 
import java.sql.*; 
import Java util *; 


class dbLogic 
{ 


String threadName = null; 

String message = null; 
InetAddress senderAddress = null; 
int senderPort = 0; 


Static int melli= 1; J7/for Join megroup command 


networkUtil network = new networkUtil (); 
dbUtil dbServer- new dbUtil(); 


boolean debug = true; 
boolean ack = false; 


vectorint mother = null; 
boolean haveMom = false; 


public dbLogic(String threadName, String message, InetAddress sa, 
{ 

this.threadName = threadName; 

this.senderAddress = sa; 

this.senderPort = sp; 

this.message = message; 


)//end constructor 


int sp) 


public dbLogic(vectorInt mother, String threadName, String message, 


InetAddress sa, int sp) 
( 

this.threadName = threadName; 
this.senderAddress = sa; 
this.senderPort = sp; 
this.message = message; 
this.mother = mother; 
this. haveMom = true; 


}//end constructor 
public void executeRequest () 


{ 
dbRequest (message) ; 
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f f FK Koo * d d d dc de d d< d d d< de de de de de de de d RE de de ke de de de de de de K de de de de de d d e ke ke 


// Function: void dbRequest (String message) 

// Purpose: This is where all the messag logic will reside 

// - service database requests based upon listenerThread name 
] | K K 3 3 d 3 d d dc dc dc de de de de de de de d de de de de de de de Re de de de de de de de de ke ke eee eae oe ee K tee e ke ke eee 


private void dbRequest (String message) 


( 


System.out.println("db request " + message); 
String mess = message.trim(); 
if (haveMom) 
mother.updateVector (mess); 
//use a string tokenizer to parse the request, the delimiter is 
//blankspace 
StringTokenizer tok = new StringTokenizer(mess) ; 


//get the data source 
String dsn = tok.nextToken(); 


//cepackage the rest of the message 
String sql = restOfMessage (tok); 
String whoAmI = threadName; 


// FOR MULTICAST COMMS 

ie dsm eguals( "all" ad 
//on _dbRequest ("1 _BnParts", sql); 
if (whoAmI.equals("a CoParts") ) 


cone quese a sCOrarts , sql); 
else if (whoAmI.equals("b CoParts") )( 
tru 
Thread.currentThread().sleep(2000); 
}catch(InterruptedException e) {} 
condbRreéguest (' beeoPartcts", sql); 
) 
eIserrQOUNhoAml.equals( sc CcoObarts 0T 
dbLogic C CIS new saebogic C(mother, “ec CoParts’ , sql, 
senderAddress, senderPort); 
cl.executeRequest(); 
) 
elsen xHonm equals RENNES CSS A 
bn_dbRequest (sql); 
} 


Y end if 


//FOR POINT TO POINT COMMUNICATION 

//can handle select and update 

else 1£ (dash. equals( "à CoParts” ). && whonmizeguals(AaMCoPaArts ME 
co dbRequesct(dsa. sql), 

) 


else 1f`( dsn.èquals ( "brcorParts" ò) \&& whoAmI. eques ("b Corarcs In 
//test to demonstrate why synch is needed 
tryl 


Thread.currentThread().sleep(2000); 
}catch (Exception e) {} 


co dbRequest (dsn, sql); 
} 
else if ( dsn.equals( "c CoParts" ) && whoAml.equals("c CoParts") ) 
dblogic C cl = new dbbogicoC(imortner AN c COPSHDES 1; 
senderAddress, senderPort); 
cl.executeRequest (); 
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) 
else dpe dsn.cauals( “l BnParts" ) && whoAml-equews ("l BnParts") ) ( 


System.out.println("making bn dbCall "); 


bn dbRequest(sql); 
) 


else( 
System.out.println("Database logic Module cannot process " + message); 


) 


)//end function 


f |] *x K 3 He de de de e de de de K de de de de de kek k k k dek k k de de de k de K de de de de de de de de de d de de d de d k d d d de K 


//-Punctrzon: coNsbhRequest(String dsn, String sal)) 

// Purpose: Companys are authorizes to perfrom database queries and to 

17 perform updates. 

// Logic: establishes a connection to the database to process the request 


f f| Kk K 3 3 H K de K d de de de de he de de de de de de de de de K de ke de de de de de k de de de de de de de de kek kek kk kK ke 


public vord co abReéquest (String dsn, String sql) 


//use a string tokenizer to parse the request, the delimiter is 
//blankspace 
StringTokenizer tok = new StringTokenizer (sql); 


//evaluate the first token <CREATE, INSERT, SELECT, DELETE> 
String command - tok.nextToken(); 


if( command.equals( "select" )) ( 


String driver Ssuncjdbecodbc.JdbcodbcDriver"; 
String userID = null; 
String password = null; 


//set the connection, jabe: cabe: a CoParts, 
dbServer.setConnection(driver, "jdbc:odbc:" + dsn, userID, password); 


//process the query 
String resultSet = dbServer.executeSQLGetString (sql); 


J/elose the connection 
dbServer.closeConnection(); 


StringBuffer buff - new StringBuffer(); 
buff.append("response db "); 
buff.append(threadName); 

buffrappend('" `"); 

buff.append (resultSet); 


String messagel = new String( buff ); 


//send the string to the user 
network. sendMessage (senderAddress, senderPort, messagel); 
print.printResultSet (threadName, resultSet) ; 


if (haveMom) { 
StringBuffer buff 1 = new StringButtem@e, 
bPNrrecbpend Send resultSet tonn: 
bortelcappendisenderaAddress); 
String r - new String(buff 1); 
Strang q Ee C ram); 
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mother.updateVector (q); 
} 
}//end if 
else if(command.equals( "update" ) ){ 


String driver — "sun.jdbc.odbc.JdbeOdbeDriver"; 
String userID = null; 
String password = null; 


//set the connection, jdbc:odbc:a CoParts, 
dbServer.setConnection(driver, "jdbc:odbc:" + dsn, userID, password); 


//process request returning a vector 
Vector resultVector - new Vector(); 
resultVector - dbServer.executeSQL(sq1); 


//close the connection 
dbServer.closeConnection(); 


StringBuffer buff - new StringBuffer(); 
buff.append("response db"); 
buffdpbpend( $25. 

buff.append(" update was successful "); 


String messagel - new String( buff ); 


//send the string to the user 
network.sendMessage(senderAddress, senderPort, messagel); 


if (haveMom) { 
String r = "update complete"; 
Sering q = r CECIN)? 
mother.updateVector (q); 
} 
dbServer.printConsole(resultVector); 
} 
else 
{ 
System.out.println(threadName + " forwarding to Battalion " + 
sq; 
if (haveMom) { 
StringButfer buff = new StringBuffer): 
buff .append ("forwarding request to Battalion "); 
buff .append (sql); 
String © = new String(burt) ; 
SEring a er Cr lim (ie. 
mother.updateVector (q) ; 
} 


//get bnPort number 

int bnPort = portumbers.gesbistenPo MM BnuPQrEs 77 
int myPort = portNumbers.getSendPort (threadName) ; 
InetAddress bnHost = portNumbers.getHost (); 


StringBuffer buff2 - new StringBuffer(); 
Due Se bpPpend (db 1 BnParts "); 
buff2.append (threadName) ; 

buff2c. append(" "x. 

buff2.append(sql); 


String message2 - new String( buff2 ); 
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String sql2 = message2.trim(); 
//send it to battalion to process 
network.sendMessage (bnHost, bnPort, myPort, sql2); 


//tell client cannot process request 

StrineBuútter butt = new StringButtier(); 

buff. append ("response net "); 

buff. append (threadName) ; 

buff.append(" Request was Forwarded to Battalion"); 


String messagel = new String( buff ); 


//send the string to the user 
network.sendMessage(senderAddress, senderPort, messagel); 


if (haveMom) 
mother.updateVector (message2); 


I end else 
|^Lend function 


//company objects can only perform SELECT AND UPDATE 
public void bn dbRequest(String inMessage) 
i 

//peel the next token off to get dsn 

StringTokenizer tok - new StringTokenizer(inMessage); 


//evaluate the first token "select part from parts" 
String dsn = tok.nextToken(); 
String sal restOfMessage (tok); 


//who sent the request 

//String dsn = portNumbers.getName (senderPort) ; 
String driver o wsuenowdbswsodbeogdbcodbocDrEYver'":; 
String useriID\< null; 


Eds. equals EAtotares A 
//assign admin userid for c CoParts db 
userID = "sa"; 


} 


String password = null; 


//set the connection, jdbc:odbcra CoPares;, 
dhéerver SetConnection(driver, "jdbc-odbec "Sn; User1D pass ordi. 


//process the query 

String resultSet = dbServer.executeSQLGetString(sql); 
//close the connection 

dbServer.closeConnection(); 


StringBuffer buff = new StringBuffer(); 

buff.append ("response db "); //select //message ! null 
buff.append (threadName) ; 

búft.append( No; 

buff.append (resultSet); 

String messagel - new String( buff ); 


//send the string to the user 
network.sendMessage(senderAddress, senderPort, messagel); 


Wena Tuner ion 
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private String restOfMessage(StringTokenizer tok) 


{ 
StringBuffer buff = new StringBuffer( ); 


//get the rest of the request 
while( tok. hasMoreTokens() ) { 


buff 
DURE 


DUET -appene Gk a: =): 
} 


String result = new String( buff ); 


return result; 
} 


)//end class 
f | Ce ee e ee e ee ee ee e ne ke de ke de de H d de de de de de % e k H e ee de de de de de de ke ke e ke de de de e e ke ke e k k de k de ke k ae k ke oe 


// End Eile: dbLogic.java 


f f| Eee ce ce e de e de e ee e de de de de k ke ke ke ke ke ke ke ke RR ke de ke de RR RR de e ke de de de k k de de ke ke ke de k d d k d k * % 


f f * Kk KX Kk K K K K 3% K K K K k K K K k H k e eee RA RARA de K K d Ke K d H dH H de e ee ee ee eee eode ek KR RK kk kk ke ke 


I Eile: dbLogic C.java 
// Purpose: This class contains the business logic to handle the 
L database requests specific to c CoParts database server. 


f f Ne e K K H k k K k k K k Kk k k k k x KX Kk * K k x K H K k k « x k k k x K k 3% k Kk * k x x k kx k % K H «K 3 k * *k 3 * 3 x d * 
import Java. util.*; 
Import Java. salo*: 
import java.net.*; 


class JDL Ici 

{ 
String threadName = null; 
String message = null; 
InetAddress senderAddress = null; 
int senderPort = 0; 


Static iHtemcrlbo- 1 //for joint megroup command 
networkUtil network = new networkUtil(); 

apta dbServer= new dbUtil(); 

vectorInt mother = null; 


boolean haveMom = false; 


boolean debug = true; 


buff.append( tok.nextToken() ); //appends the sql statement 


public dbLogic C(vectorInt mother, String threadName, String message, 


InetAddress sa, int sp) 
{ 

this.threadName = threadName; 
this.message = message; 
this.senderAddress = sa; 
this.senderPort = sp; 
this.mother = mother; 
this.haveMom = true; 


} 


public void executeRequest () 


{ 
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{ 


dbRequest (threadName, message) ; 
} 


//compnay objects can only perform SELECT AND UPDATE 
private void dbRequest (String dsn, String sql) 


//use a string tokenizer to parse the request, the delimiter is 
//blankspace 
StringTokenizer tok = new StringTokenizer (sql); 


//evaluate the first token "select part from parts" 
String command - tok.nextToken(); 


if( command.equals( "select" )) ( 


String ariver == "sun. jJabc.odbc.JabcOdbcDriver”; 
Sering userID = "sa"; 
String password = null; 


//set the connection, jdbc:odbc:a CoParts, 
dbServer.setConnection(driver, "“jdbc:odbc:" + dsn, userID, password); 


//process the query 

String resultSet = dbServer.executeSQLGetString(sql); 
//close the connection 

dbServer.closeConnection(); 


StringBuffer buff = new StringBuffer(); 
buff.append("response db "); //select //message null 
buff.append(threadName); 

butff.append( com. 

buff.append(resultSet); 


String messagel - new String( buff ); 
//send the string to the user 


network.sendMessage(senderAddress, senderPort, messagel); 
print.printResultSet(threadName,resultSet); 


| endet 
else if(command.equals( "update" ) ) { 
String driver.=. "sun. jdbclcedbevJdbe0ebebriver"; 


String userID = null; 
String password = null; 


Set tine connection, j)db¢:ccbc.4 Cerares, 
dbServer.setConnection(driver, "jdbc:odbc:" + dsn; userID, password): 


//process request returning a vector 
Vector resultVector - new Vector(); 
resultVector = dbServer.executeSQL(sql); 
//close the connection 
dbServer.closeConnection(); 


StringButter buff -— new StringBuffer(); 
buff.append("response db "); //select //message ! null 
buff.append (threadName) ; 

buff .append(" Ty; 

buff.append(" update was successful "); 


String messagel - new String( buff ); 
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//send the string to the user 
network.sendMessage(senderAddress, senderPort, messagel); 


//to server screen 

if (debug) System.out.println("SoL = " * sql * " processed by " + 
threadName); 

//print it to the server screen 

dbServer.printConsole(resultVector); 


} 
else 


{ 


System.out.println(threadName + "cannot process forwarding it to 
Battalion" + sql); 


//get bnPort number 
int bnPort = portNumbers.getListenPort("1 BnParts”); 


int myPort = portNumbers.getSendPort (threadName) ; 
InetAddress bnHost = portNumbers.getHost(); 


StringBuffer buff2 = new StringBuffer (); 
buti2 append (de een heres. ), 
buff2.append(threadName) ; 

Dutr2cappendi v); 

buff2.append(sql); 


String message2 = new String( buff2 ); 
//send it to battalion to process 
network.sendMessage(bnHost, bnPort, myPort, message2); 


//tell client cannot process request 

StringBuffer buff - new StringBuffer(); 
buff.append("response net "); 
buff.append(threadName); 

buff.append(" Request was Forwarded to Battalion"); 


String messagel = new String( buff ); 


//send the string to the user 
network.sendMessage (senderAddress, senderPort, messagel); 


}//end else 
Prend function 
}//end class 
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// End File: dbLogrc C.Jjava 
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77 Eile: responseLogic.java 

// Purpose: This class contains the logic for handling the responses 
d from objcets. Responses might be either query resultset 
/ / or an acknowledgement or a network response. 


f f koe ke e *k ke ke e e K 3 3 he Kk e ce ke *% K K K K ke K K K K 3 K K Kk K Kk ke d K K K K k ke K K K K k 3K K K Kk K K K ck cce kk kk K 3 k 


import Java net... 
import maven sal > 
importara cuca 
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class responseLogic 


{ 


String threadName = 
String message = 


int senderPort = 0; 


static Int meres — 1; 


networkUtil network 
abu P 


vectorInt mother = 


null; 
iud. 
InetAddress senderAddress - 


null; 


//for join mcgroup command 


= new networkUtil(); 
dbServer- new dbUtil(); 


null; 


boolean debug = true; 


public responseLogic(String threadName, String message, 


InetAddress sa, int 


Sp) 
{ 
ijs 
this. 
this: 


threadName = 
senderAddress = 
senderPort = 


threadName; 
Sa; 


Sp; 


InetAddress sa, 


this.message - message; 


)//end constructor 


public responseLogic(vectorInt mother, 
int sp) 

( 

threadName; 

sa; 


threadName = 
senderAddress = 
senderPort = sp; 
= message; 
mother; 


this. 
this. 
this. 
this.message 

this.mother = 


ly /end “ecenstructor 


public void executeRequest () 


( 


responseRequest (message) ; 


} 


public void responseRequest (String message) 


{ 


//use a string tokenizer to parse the request, 


blankspace 


StringTokenizer tok = new StringTokenizer (message); 

of resonse «db, ack, 

command = tok.nextToken(); 

from — tok.nextToken(); 

String restOfMsg = restOfMessage(tok); 

if (command.equals( "db" ) ){ 
//a synchronized print function 
print.printResultSet (from, restOfMsg); 


//type 
String 
Strang 


//send response to mother 
mother.updateVector (from) ; 
mother.updateResultList (restOfMsg) ; 


143 


String threadName, 


String message, 


the delimiter is 


}//end if 


else if ( command.equals( "ack" ) ){ 
Systemcout.printin(" Anack" cra from " wsenderAddress mm EE 
senderPort); 
) 
else if ( command.equals( "net" ) )( 


) 


print.printMessage(from, restOfMsg); 
mother.updateVector(from); 
mother.updateVector (restOfMsg) ; 
mena LE 
y/7ënd function 


private String restOfMessage (StringTokenizer tok) 


{ 
StringBuffer buff = new StringBuffer( ); 


//get the rest of the request 
while( tok.hasMoreTokens() ) { 


buff = buff.append( tok.nextToken() ); //appends the sql statement 
DUET pur -append ( S r 9 


} 


Strand result. = new 3cring( burt); 
String res = result.trim(); 


return res; 


) 


f| f| FC e ke e ke ke ke ee HR e RO hehe ke e ehe e e ce he he de hehe ehe e he e he ee ke e e ke ce ke e e e ke ke ke ce ke e ck e ke ke ke ek kk 


// End File: responseLogic.java 
f | KC ke e ke ke ke e e ee e ke ke he ke e ke e he e ke ke ke he he hee e ce he e eke ee eke ete ke ke e ke hee e ck ke ck he ke ke ke ke kk e he ke ke ke 


f f NK k k ke ke he ee e he K ke ee ee K e k K Kk K k k K e k k k % k k k K k k k k e k Kk k Kk Kk Kk k Kk k k Kk k k k K Kk ke k K e * k ke kk 


// File: networkLogic.java 
// Purpose: This class contains the logic for handling the network 


protocol messages from objects. Network request messages 
might be either a join command (to a multicast group), 
or leave command (from a multicast group), or an ack, 

or a query about the aliveness of the object. 


f /| Neck ee dc 4 she sehe e Fc dc de he ehe she ehe he hehe he he he Ae de de de de dc de Se de de e he de dc K hehe e ce hehe de de de de de de H de de de de de d H de KX 


iImport<=java. neti*; 
import JAvVAAtEL Le 


class networkLogic 


{ 


String threadName = null; 

String message = null; 

InetAddress senderAddress = null; 

int senderPort = 0; 

static int mcID = 1; //fof join megroup commana 


networkUtil network = new networkUtil(); 


vectorInt mother = null; 
boolean haveMom = false; 
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YESA EDI SS AA E A AS 


// Function: networkLogic(String threadName, String message, InetAddress sa, 


LIEBE SD) 
// Purpose: handlet net protocol 


O IIS RI IÓ SAA A A E E UR 


public networkLogic(String threadName, String message, InetAddress sa, int 


sp) 
( 


this.threadName = threadName; 

this.senderAddress = sa; 

this.senderPort = sp; 

this.message = message; 
end constructor 


AR ES RER ER AA A 
// Function: networkLogic (String threadName, String message, InetAddress sa, 


//int sp) 
// Purpose: handlet net protocol 


A CEU 
public networkLogic(vectorInt mother, String threadName, String message, 
InetAddress sa, int sp) 


( 
this.threadName = threadName; 


this.senderAddress = sa; 

this.senderPort = sp; 

this.message = message; 

this.mother = mother; 

this. haveMom = true; 
Wend Constructor 


public boolean executeRequest() 


{ 


networkRequest (message, threadName); 
return true; 


VU E Ek ok eie e WOO OR eoo Kok AREA RAR RARA AA 


// Function: networkRequest(String message) 
// Purpose: 


f| f| E Ree ee dee eee dee e echec ee dee e de he e ehe e he eode e coke e hee ee e oe e he de ee e e he e e he 
private void networkRequest(String message, String threadName) 
{ 


StringTokenizer tok = new StringTokenizer (message); 
String command = tok.nextToken(); //get the first token 


lf) (ecemmand.equels( "Jon J J) 


//get the next two tokens 

String mcIP - tok.nextToken(); 
String a = tok.nextToken(); 

int mcPort = Integer.parseInt (a); 


//display result in gui 
if (haveMom) { 
moctbpesupdateVector(' Join " t mcrP c 2t omcPOoSs). 


//set the mcListen flag 
mother.setMCListen(true); 


StringBuffer buff - new StringBuffer( threadName ); 
buff.append(" mc"); 
buff.appendimclD); 
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MOLDES 
String mcThreadName = 


//create a new mcLister thread 
if (haveMom) { 
mcListenerThread mclistener 
mcThreadName ); 
mclistener.start(); 
jelse{ 
mcListenerThread mclistener 
mcThreadName ); 
mclistener.start(); 


mcPort; 


) 


//send a an ack back 
int myPort - 
//format message 
StringBuffer buffl = 
but£l.append (“met ack "); 
buffl.append(threadName); 
bufrl.append( <)> 


String response - 


new String(buff); 


= new mcListenerThread (mother, mcIP, 


— new mcListenerThread (mcIP, mcPort, 


portNumbers.getSendPort (threadName); 


new StringBuffer(); 


new String( but£l }; 
System.out.println("Sending response: 


" + response); 


//use private line so receiver can get your addrss and port 


network.sendMessage (senderAddress, 


} 


else if ( command.equals( "leave" 


String ip ~ tek .nextToken()7; 
//display result in gui 
if (haveMom) ( 
mother.updateVector("leave 
//set the mcListen flag 
mother.setMCListen(false); 
) 
) 
//incoming message 
else if ( command.equals( "ack" ) 
String rom = 


//print the ack to the screen 


senderPort, myPort, response); 


) ){ 


HUE) 


D 


restOfMessage(tok); 


Svstem.outeprinrin(t"ack from "+ rom}, 
mother.updateVector("ack from " + rom); 


) 
//outgoing message 
else if ( command.equals ( 


int myPort = 
//format message 
StringBuffer buffl = 
Bufíl.append ("net message "); 
bufíl.append (threadName) ; 
buffl.append(" is alive "); 


String response - 


"respond" ) 


n 


portNumbers.getSendPort (threadName); 


new StringBuffer(); 


new String( 5butfl ); 


//use private line so receiver can get your addrss and port 


network.sendMessage (senderAddress, 


if (haveMom) 


senderPort, myPort, response); 
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mother.updateVector (response); 


} 


/foutgoing 
else if (command.equals( "message") ) { 
String contents = restOfMessage (tok); 


System.out.println(contents); 
if (haveMom) mother.updateVector (contents); 


) 
else{ 
System.out.println("Network Module cannot process request " + 
message); 


) 


)//end processPackage (message) 
private String restOfMessage(StringTokenizer tok) 
( 

StringBuffer buff - new StringBuffer( ); 


//get the rest of the request 


while( tok.hasMoreTokens () )( 
buff = buff.append( tok.nextToken() ); //appends the sql statement 
buff - buff.append( " " ); 


String result - new String( buff ); 
String res = resulteotrim(); 


return res; 


}//end networkLogic 


f f * koe hehehe *% d d de de d d d d d he e hehe he e he e e e he e e hehe he e bee he e e he he e he de hehe be he dee he ehe de he dee dece e he he ee e 


7 End File: networkLogic. java 


f f koe ce K e d de d K d % de d d d K d de d d d d d de de de de K de K de d de de d Ke Ke de d de d de de de de de K de d de % d de Ke K de de he de de d e ek 


f f Kk * 3 3 ROI H d d d de de de de de de de de de de ke K H de de de de de ke ke de de de de e de d de deke de de de de ke d ke He ke de de ke K d de de e e e d de de de k K K 


"^ rile: dbUtil.java 

// Purpose: A utility class with functions to establish a connection, 
II submit a SQL Statement, execute a query, get database 

n meta data and so on. 


f f * he ee hehehe dede he K de e dece de de de de H 3 d he de K de K de de d de He ee e he de K de de d de de de de d Ke de de e de he ehe de de % d de de e dece 


import java.sgl.*; 
Enport jJava.util-*; //£or vector and hash 


public class dbUtil | 


private Connection con = null; 
private Statement stmt  - null; 


private static final boolean debug = false; //for debugging 


f f Ne he che e ce e he ee e e he he e de de de e e he de he de e de e e de de e de de e e e e ek ek 


// Bunct¥en. bool —setConnection (String driver, Séringurl, 

17 String name, String password) 

// Purpose : constuctor which allows user to specify connection 

f f kk e He de ce de dc de ke de de de K de Se de Se e K de e de de He de de V de K dH d K de V $ d de H de $e % 

public boolean setConnection(String driver, String url, String name, 
password) 


( 
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try{ 
Class. forName (driver); 
con = DriverManager.getConnection(url, name, password); 


}catch (SQLException e) { 

System.out.printlin("Failed to connect to database: " + url + " " + 
e.getMessage()); 
return false; 

}catch(ClassNotFoundException e) { 
SyStem.out.printin( Unable to findsdriversciacs.4)., 
return false; 

} 

System.out.println("Connected to Database :" + url); 

return true; 

)//end setConnection 


f f kk k k k k k k k k * k k k k k e ke ee ee k k k ke ck k * k k k x e ke ee x ke ek 


// Function Toge ConnectionString driver, String wel, 
ER String name, String password) 
// Purpose : returns a connection object to client 
[[*k*k*k*k*k*k k *k k k k k k k k k k k k k k k x k k k k k k k k k x AR x e ek 
public Gennection getConnection (String driver, String our’, String name, 
String password) 
{ 
try{ 
Class.forName (driver); 
con = DriverManager.getConnection(url, name, password); 

}catch(SQLException e) { 

System.out.println("Failed to connect to database: " + url + " " + 
e.getMessage()); 
return null; 

}catch(ClassNotFoundException e) { 
System.out.println("Unable to find driver class."); 
return null; 

) 

System.out.println("Connected to Database :" + url); 

return con; 

)//end setConnection 


f f Fk k k k k k k k k k k k k k k e k k k k k k k k k x e e Kk k e k k k k * k Kk K x 


// Function: closeConnection( 
// Purpose : closes the Connection to the datasource 
f kk ke *k k k k k k k k ke e ee ke k k k k k k k k k k % k 3% k k k x k * K k x kx RK 


public void closeConnectiont) 
( 
Ey 
Con close): 
} 
catch (Exception e) 1 
e.printStackTrace (); 


) 


}\//end eloseConnection 


f f kk k k k k k k k k k K k k x k e Kk k k k de k k k k k k x e k k k kek k k k k k k 
// Function: executeSQL(String sql) 

// Purpose : dynamically get table data, based upon a sql statment 
L returns a vector with resultSet 

// Ref: DataBase Programming with JDBC and JAVA 

f f kk k k k k k k k k x k k k k e k k ke k k * k k k k k k k e e k % k k % k k % * x 

public Vector executeSQL (String sql) 

( 
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Vector resultVector = new Vector(); //to store resultSet by hashTables 


int coles 


try 
stmt = con.createStatement(); 


if (stm execute (sql) ) { //returns true if sql produces a resultSet 


//get the SQL results 
ResultSet result = stmt.getResultSet(); 


//get the resultSet metadata 
ResultSetMetaData meta - result.getMetaData(); 


//how many columns 
cols - meta.getColumnCount (); 
if (debug) System.out.println("Number of columns: " + cols); 


int xx =0; 
//increment through the rows (tuples) of the result set 
while(result.next() )( 


//each tuple gets a hashtable to store information 
Hashtable rowResults = new Hashtable(cols); 


//increment through the tuple <name, ssn, dept> 
Ort 1x = 07 1x < cols; 1x>+) [ 


//get the object <string, int ect.> stored in column 
index 1,2, .n. and store in an objec 

int index = ix t-l; 

Object obj = result.getObject (index) ; 


//use the column lable as the hash key and put object 
hashtable 
if(obj == null) { 
rowResults.put (meta.getColumnLabel (index), 
} else { 
rowResults.put (meta.getColumnLabel (index), obj); 
)//end if 
)//end for 


XD S 


//add the hash object to the vector 
resultVector.addElement(rowResults); 
)//end while 


//System.out.println(resultVector.capacity()); 


return resultVector; 


) 


return null; //SQL statement did not produce a ResultSet 


} 

catch (SQLException e) { 
Svstemoerr printin("Failed to executeSOL(" 4 sql 4.) function"); 
e.printStacekTracet); 
return null; 


} 


)//end executeSQL 


f f| EC ke k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k ke koe ck k k k k 
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// Function : printConsole (Vector v) 
// Purpose : Prints the data taken from hash table which 
17 is received by vector v 
[[t*k*k*k k k k k k k kx k k k e k k k k % k k x k k e k % x e dx k x k k x k kx k x k e e ek e ek ek 
public void printConsole (Vector v) 
{ 

if (v == null)( 

//do nothing 
) 


else! 
Vector result Vector v; 
int vectSize = resultVector.size(); 


for(int ix = 0; ix < vectSize; xtra 
//take the hashtables from the vector one by one 
Hashtable myHashTable = (Hashtable) resultVector.elementAt (ix); 
//enumerate the objects in hashtable 
Enumeration hashEnum =  (Enumeration)myHashTable.elements(); 


while (hashEnum.hasMoreElements() ) { 
Object myObj = (Object) hashEnum.nextElement (); 
System. out  println(my053):; 

)//end while 


)//end for 
)//end else 
)//end printHashedVector() 


f| | E Ce e e e ee ee e ee e % e * K AAA AR RRA RR A A te 

// Function: executeSQL(String sql) 

// Purpose : dynamically get table data, based upon a sql statment 
77 returns a vector with resultSet 

// Ref: DataBase Programming with JDBC and JAVA 


f| f| *k k Kk k Kk e Kk * % K % K % e ee K d K K K e ehe K * k % K K 3 d Kk RARA x 
public String executesOLGetString (String sql) 


{ 
//System.out.println(" executeSQLGetString Request # " + sqlRequest++) ; 


Sering resultString e null; 


try 
stmt - con.createStatement(); 


au srmrtoexecubretsol at //returns true if sql produces a resultSet 


Resultset result set = stmt. geckesultcer (); 
//put resultSet in string format 
resultString = processResults(result_set); 


| eno ïf 


return resulestring; 


} 
catch(SQLException e){ 
System-err prinelin(/Failed to execute OL + sql + ") function"); 


e.printStackTrace(); 
return, null; 


} 


}//end executeSQLGetString(String sql) 


f| /| E he eee dee echec ee ke de ehe he ehe he ee ehe ee de he he he he dee ee ee ek eee 


// Function: String processResults(ResultSet results) 


// Purpose : processes resultSet into a string 
1 : ',' is being used as a deliminator for String Tokenizer 


t 


150 


] | 3 3 3 3 RR ee ee 


public String processResults(ResultSet results) throws SQLException 
{ 


TEJA! 
ResultSetMetaData meta - results.getMetaData(); 
StringBuffer bar = new StringBuffer(); 
Strinomourter = "T"; 
int cols = meta.getColumnCount (); 
int Bewseount — 0; 
int i, width = 0; 


// Prepare headers for each of the columns 
// The display should look like: 


Pe 77 = - 
Zu | Column One | Column Two | 
RS > >= á<=4;á> > >= A 
| Row 1 Value | Row 1 Value | 
fm mm mm mm ——— 


// create the bar that is as long as the total of all columns 
for isl; i<=cols; i++) { 
width += meta.getColumnDisplaySize(i); 
}//end for 
width += 1 + cols; 
for(i=0; i<width; i++) { 


bar.append('-"); 
|^ end Ec 
bar.append('Mn'); 
bar.append(","); //my deliminator 
buffer += bar + “|”; 


// After the first bar goes the column labels 
forlis mi cols iNi 4 
StringBuffer filler = new StringBuffer (); 
String label = meta.getColumnLabel (1); 
int size = meta.getColumnDisplaySize(i); 
Ince 


// If the label is long than the column is wide, 
// then we truncate the column label 
if( label.length() » size ) { 
label = label.substring(0, size); 
)//end if 
// If the label is shorter than the column, pad it with spaces 
if( label.length() < size ) { 
Let e 
x = (size-label.length())/2; 
=D J<x; j++) 1 
filler.append(' '); 
)//end for 
label = filler + label + filler; 
if( label.length() » size ) ( 
label = label.substring(0, size); 
) 
else { 
while( label.length() < size ) { 
label += " "; 
)//end while 
}/end if 
)//end if 
// Add the column header to the buffer 
buffer = buffer + label + "|"; 
}//end for 
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I Add rhe lower bar 
Butter =Dufter + "ino" a 
// Format each row in the result set and add it on 


while( results.next() ) { 
row count-t-t; 
buffer += "|"; 


// Format each column of the row 
for(i=l; i<=scols; Ite 
StringBuffer filler = new StringBuffer({); 
Object value = results.getObject (i); 
int size = meta.getColumnDisplaySize(i) ; 
String str = value.toString(); 
if ( Str length) Sr: 
str = str. substring(0 size): 
}//end if 
1f( str:lengtna()"e size mA 
Ine I 


x = (size-str.lengthi())/2; 
LOTO UNIX JE) d 

filler.appeëend(' `); 
}//end for 


str = filler + str + filler; 
1f{ str.length() > size JM 
str = str.substring(0, size); 
) 
else { 
while( str.length() < size ) { 
str +=." "o 
}//end while 
} 
} 
butter = butter + (str + "> 
)//end for 
buffet = butter Pa +", 
}//end while 
// Stick a row count UD at ene cor 


NEON CO UNES IA 
buffer = "No rows selected.\n" + "," + buffer; 
} 
else if( row count == 1 ) ( 
buffer = "1 row selected.\n" + "," + buffer; 
} 
else { 
buffer = row count + " rows iselected.1n ik "," buffer; 


} 


return buffer; 


catch (WSOLEXxception e ) 4 
throw e; 
finally í 
try { results.close(); ) 
catch SOLException.e ) 4 `? 
} 
}//end processResults (ResultSet results) 


}//end class 


f [| * eee de dede de dece ee de e dece de de de e hehe e dee de e e ehe he he e he je e e hehe de ehe hee oe dece oe hehe dee e hehe ede dece ee ee 


// End File: dbUtil.java 


f f| * ehe de he Se te de e eee de Ve de de de de dc de de de de K Ke de de de RARA RAR REA RAR RAR ARA AAA ARA 
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E A A AA AS E oko KK A A ee 


Be: networkUtil.java 
// Purpose: Utility package to send requests, listen for requests, 
14 send multicast requests and so on. 


PNR dc 3< de RE HR Ne KO RE RAR ER RSR CAE RERO KR RENE RER NARRA koe ee e ee e eoe 


import java.util. m Corector 
import java.io //for sleep function 
import java.net.*; 


public class networkUtil 
( 


] | H 3 3 de e e ke de de de de de e de ee de de de de e de de e de e de de e e e de de e de de e ehe ode de de e de de de de de e de de e e 


// Function: mcSendListenForResponses(vectorInt mother, String mcAddress, 


ef, int mcPort, int expReplies, int 
timer, String message) 

// Purpose: vectorInt - gui interface, send message to mulicast group, 

17 The function will block waiting for N repsonses or until it Times Out 


f| f| E 3633 4436 36] HK de Se de 4 de de de eoe e de e ee he he de e de e ehe de de e he de de de de de de de RR RARA 


public void mcSendListenForResponses(vectorInt mother, String mcAddress, int 
mcPort, int expReplies, int timer, String message) 
( 
int numReplies = 0; //for acks 
o Co Lei = ly 


//for message 
DatagramSocket socket = null; 
int assignedPort = 0; 


InetAddress mcDA = null; 


byte(] buff » new byte[1024]; 
buff = message.getBytes(); 


ET 
//os dynamically assigned port 
socket = new DatagramSocket(); 
assignedPort -» socket.getLocalPort(); 
socket.setSoTimeout (2000); //set so socket times out every 2 seconds 


//get group address 
mcDA - InetAddress.getByName (mcAddress); 


//create packet 
DatagramPacket packet - new DatagramPacket(buff, buff.length, mcDA, 


MEPOFrt) ; 


//send the packet 

socket.send (packet) ; 
}catch(Exception e) { 

System.out.println(e); 


} 


jj sl Sten for n responses or timeout *** 

long startTime = System.currentTimeMillis(); 

long elapsedTime = 0; 

long timeOut = timer; 

System.out.println(message +" startTime " + startTime); 


while( (elapsedTime < timeOut) && (numReplies < expReplies) ){ 


//creat a inPacket for incoming messages 
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byte [] buff 1 = new byte[1024]; 
DatagramPacket inPacket = new DatagramPacket (buff 1, buff 1.length); 
try { 
//blocks for 2 seconds then throwInteruptIOException 
elapsedTime - System.currentTimeMillis() - startTime; 
socket.receive(inPacket);  //throws IO Exception 


//create a messageHanlder object using the 2nd constructor that 

//does not increment off the sendPort synchListen 

messageHandlerThread handler = new messageHandlerThread (mother, 
MBScket, "mes MH # mes MA 

handler.start(); 

mcSL_MH++; 

numReplies++; 


}catch (SocketException e) { 
System.err.println(e); 


}catch (IOException e) { 
elapsedTime = System.currentTimeMillis() - startTime; 
System.out.println("timeOutCheck, elapsedTime | " -* elapsedTime); 
) 
)//end while 


if (elapsedTime » timeOut) 
System.out.println(message -*" TimedOut"); 
mother.updateVector (message -* " TimedOut"); 


socket.close(); 
end function 


f f| K K * 3 e ke e d d dc K de K K de K de de d de de de de de de de de de de de de de de de de de de de K d d d K d K $ K A ke e kk K 


// Function: sendListenForResponses (vectorInt mother, Vector recipVector, 


iy String message) 

// Purpose: user can send a message to N recipiants 

14 The function will block waiting for N repsonses or until it Times Out 
/ / Object recieves an interface object to mother object 


f| | Fk ehe ke e hehe ehe ee de de de dc hee ee hehe ehe ee ehe he ee de de Ke de de H de de d de De de d de K de d Ke K d K 


public void sendListenForResponses (vectorInt mother, String recipiant, 
String message, long timeOut) 


( 


//for acks 

int numberAcks = 0; 
int expectedAcks = 
//for times 

long startTime = 0; 
long elapsedTime = 0; 

//for this message 
DatagramSocket socket = null; 
int myPort = 0; 


//recipiants socket info 
InetAddress addr = null; 
int port = 0; 


{//*** get a Socket rrr 
try{ 
//os dynamically assigned port 
socket = new DatagramSocket(); 
myPort = socket.getLocalPort(); 
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//set socket timeout parameter 
socket.setSoTimeout (2000); 
}catch(SocketException e) { 
SYStem.cuc.printin(e); 
} 


//get recipiants address and port 
addr = portNumbers.getIP(recipiant); 
port = portNumbers.getListenPort (recipiant); 


//*** prep the message *** 

byte[] buff3 = new byte[1024); 

buff3 = message.getBytes(); 

DatagramPacket packet = new DatagramPacket (buff3, buff3.length, addr, 


Dort); 


//send it 
Ery 
socket.send (packet); 
}catch (IOException e){ 
System.err.println(e); 


} 


I + listen for mn responses or timeOut *** 
startTime = System.currentTimeMillis(); 
System.out.println (message +" startTime " + startTime); 


while( (elapsedTime < timeOut) && (numberAcks < expectedAcks) ) { 


//creat a inPacket for incoming messages 
byte [] buff = new byte[1024]; 
DatagramPacket inPacket = new DatagramPacket (buff, buff.length); 
try{ 
//blocks for 2 seconds then throwlnteruptIOException 
elapsedTime = System.currentTimeMillis() - startTime; 
Socket.receive(inPacket); //throws IO Exception 


//create a messageHanlder object using the 2nd constructor that 
does not increment off the sendPort synchListen 

messageHandlerThread handler = new messageHandlerThread (mother, 
inPacket, recipiant + " Response"); 

handler.start(); 

numberAcks++; 


}catch (SocketException e) { 
System.err.println(e); 


PCA cCCHAMOEXCeptIon e) 1 
elapsedTime = System.currentTimeMillis() - startTime; 
Systemes -printin(check tor timeQgue, elapsedTime | " + 
elapsedTime); 
) 
)//end while 


if (elapsedTime > timeOut) { 
System.out.println(message -" TimedOut"); 
mother.updateVector(message * " TimedOut"); 


) 
Socket.close(); 
| send function 


[ [k*k*k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k 3% k k k K k k k k k k k k * * * 


// Function: sendListenForResponses (Vector recipVector, String message) 
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// Purpose: user can send a message to N recipiants 


LJ 


The function will block waiting for N repsonses or antil ic Tines Oum 


// NON GUI VERSION 


f. | FC ke e de e e de de de de e de de de de de de de de de de de de ke de de de de de de de ke H de K K ke de de de ke de ke de K K de ke K e ke 


public void sendListenForResponses (String recipiant, String message, long 
timeOut) 


{ 


port); 


//for acks 

int numberAcks = 0; 
int expectedAcks - 1; 
//for times 

long startTime = 0; 
long elapsedTime = 0; 


//for this message 
DatagramSocket socket = null; 
int myPort = 0; 


//recipiants socket info 
InetAddress addr = null; 
int port = 0; 


JSF get a socket *** 

thy 
//os dynamically assigned port 
socket = new DatagramSocket (); 
myPort = socket.getLocalPort (); 
//set socket timeout parameter 
socket .setSoTimeout (2000); 

}catch (SocketException e) { 
System. out.printin(e); 


} 


//get recipiants address and port 
addr = portNumbers.getIP (recipiant); 
POLE = portNumbers.getListenPort (recipiant); 


//*** prep the message *** 

byte[] buff3 = new byte[1024]; 

buff3 = message.getBytes(); 

DatagramPacket packet = new DatagramPacket (buff3, buff3.length, addr, 


//send it 
tryl 
socket.send (packet); 
}catch(IOException e){ 
System.err.println(e); 
) 


//*** listen for n responses or timeOut *** 
startTime = System.currentTimeMillis(); 
System.out.println(message +" startTime " + startTime); 


while( (elapsedTime « timeOut) && (numberAcks « expectedAcks) )í 


//creat a inPacket for incoming messages 
byte [] buff = new byte[1024]; 
DatagramPacket inPacket - new DatagramPacket (buff, buff.length); 
try 
//blocks for 2 seconds then throwInteruptIOException 
elapsedTime - System.currentTimeMillis() - startTime; 
SoCket.receive(inPacket); //throws IO Exception 
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//create a messageHanlder object using the 2nd constructor that 
does not increment off the sendPort synchListen 

messageHandlerThread handler = new messageHandlerThread(inPacket, 
recipiant + " Response"); 

handler.start(); 

numberAcks++; 


}catch (SocketException e) { 
System.err.printin(e); 


}catch (IOException e) { 
elapsedTime = System.currentTimeMillis() - startTime; 
System.out.println("check for timeOut, elapsedTime | " + 
elapsedTime) ; 
} 
}//end while 


if (elapsedTime > timeOut) 
System.out.printliln(message +" TimedOut") ; 
socket.close(); 
}//end function 


f| | Coke e eoe de de * de de de de Se d e e He H K de de de de de Se e de de Ke de de de de de de Se de de de de de e de d de d K K ke d ke ke 


// Function: sendMessage(String ip, int port, String message) 
// Purpose: sends a mutlicast message to specified group 
f| f eoe de de de ke ke ke ke ke e ke de ke de de de de de de de ke ke de de de de de de de de de de de He de de de de de de de de de de d d de de de K ke 
public void sendMulticastMessage(String ip, int port, int myPort, String 
message) 
{ 
CIV 


DatagramSocket socket = new DatagramSocket (myPort); //port 5000 


byte[] buf = new byte[512]; 
buf = message.getBytes(); 


// send it 

//the group identifier is 230.0.0.1, monitoring port ddds 

InetAddress group = InetAddress.getByName (ip) ; 

DatagramPacket packet = new DatagramPacket (buf, buf.length, group, 
Port): 

socket.send (packet) ; 


//close the socket 
Socket.close(); 


} cateh (IOException e) ( 
e.printStackTrace(); 


) 
)//sendMulticastMessage(String ip, int port, String message) 


JL RR e e ke e e e de e ee de e de de de e de de de de de e e de de de e de e k de de ke de ke e de de de de de ke ke k e e ke ke ke 


// Function: void sendMessage(InetAddress address, int port, String answer) 
// Purpose: creates a DatagramSocket, sends a message to the address and 
Ls port Supplied. 
f| | E Ke dc de de d d de de de de de de ke de de de de de de de de de de de de de de de de de e de de de He de de de de de de de de de d d de ke k ke 
public void sendMessage(InetAddress da, int dp, String message) 
{ 

try( 

DatagramSocket socket = new DatagramSocket (); 
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byte[] buff = new byte[1024]; 
buff - message.getBytes(); 


//prep the packet 
DatagramPacket packet - new DatagramPacket(buff, buff.length, da, dp); 


//send the packet 
socket.send (packet); 


socket.closel); 


catch (SocketException e) ( 
System. out printer; 
aten TOBEXcCeption e) { 
SYSteEM. Out .print (e) ; 
} 
} 


public void sendMessage (String sDA, int dp, String message) 
( 
CEJA 
InetAddress da = InetAddress.getByName (sDA) ; 
DatagramSocket socket - new DatagramSocket(); 


byte[] buff = new byte[1024]; 
buff - message.getBytes(); 


//prep the packet 
DatagramPacket packet = new DatagramPacket (buff, buff.length, da, dp); 


//send the packet 
socket.send (packet) ; 


socket.close(); 


)catch (SocketException e)( 
Systemmout.print&(e)* 
}catch(IOException e){ 
System out .printiel; 
} 
} 


[[*kk*k*«k «k k kk « k x x k k xk k x x x x kx ER x x x k x x x k x x e k te te k e e k k e e e e x x x ke 


// Function: void sendMessage(InetAddress address, int port, String message) 
// Purpose: creates a DatagramSocket and send a message 
// Parameters: da = destination address, dPort = destination port 
"rA sPort = port to use to send 
f [| E Chee e e e e e ee ee e e ee ede ede ede e ee ede ede ehe e e e he ehe e he e he e de e e e e e de ee 
public void sendMessage(InetAddress da, int dPort, int sPort, String 
message) 
{ 
ELY 
//create a socket to use 
DatagramSocket responseSocket = new DatagramSocket (sPort) ; 


byte[] buff = new byte[256]; 
buff = message.getBytes(); 


//prep the packet 
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DatagramPacket packet = new DatagramPacket (buff, buff.length,da, 
Geert); 


//send the packet 
responseSocket.send (packet) ; 
responseSocket.close(); //close the socket 
}catch(SocketException e){ 
System. Out. print (e); 
}catch (IOException e) { 
System.out.print (e); 
) 
} 


}//end class 
f f * kx K Kk K K K K H *K K H d 3 K ÍH d K d d dc Se dc de de Se de de de de K K de de de d de e de e e she dS de Se ded K H Kk d K K Kd d dk K SK d Kd Kk 


7 End File: networkUtil.java 


f | kk kk ke k k kx k k k k x k x x k k x kx x k k k k « k k %« k %k k % k xX « k k % k k k % k k k xk k k * k k % k k ko ko % k $ % k À * 
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// File: portNumbers.java 
// Purpose: A class that manages the listening and sending port 
as number allocation and utility function related to that. 


f | 3 3 oe RAR RARA RR e Se Se de Se Se Se de de oe oe oe ke d de Se oko eo eke ok K K ke ok e e 


import java.net.*; 
public elass portNumbersqi 


static IDE BHEOTRS = OL Oy, 
Static Ine onrOrt law oul, 
Stattwevint a Corortsr= SUIS; 
Stat le ne a COrorth, — 2014; 
Stat les mrs Corercs = 5015, 
Static int bo Cororcl = (5016, 
Static Int C COROrtS = 2017, 
Static ant eG 7eororehL — 5015; 


static e er ig ACO Lee Nr 1201-01; 
staticiatring D COLE NN 120.1 01%; 
SEabicsoPrIng C CODE = UPS E20.1 757; 
Static ering PBNIP = Tios 91 


Static String host = 194120 1-91; 


public static InetAddress getHost () 
( 
AN 
return InetAddress.getByName (host); 
) catch (Exception e)( 
return null; 
) 
) 


public static InetAddress getIP(String unit) 
{ 
InNesuAddress result =- nunl; 
Ery 
if (unit -eguals("a CoParts") ) 
result = InetAddress.getByName(a COIP); 
else te umPtecqualst'becoParts'")) 
result = InetAddress.getByName(b CoIP); 
else et unit eduals("e CoParts")) 
result = InetAddress.getByName (c_ColP); 
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} 


elcseni i unit equals ( a enrares DQ 
result = InetAddress.getByName (BnIP); 
else 
result = null; 
return result; 
}catch(Exception e) { 
System.err-printin ("Could not findi i Eora wun or 
return null; 
} 
}//end 


public static String getName (int senderPort) 


( 


if (sender Port == (a CoPOrtL)) 
return a C OPartS",; 

else Ifi SenderPort == ( b CoPortL )) 
return O COPartSi; 

see E Ener Ore MECO Lor Li 1) 


TSLUEn A CASO bares 


else return null 


) 


public static int getlistenPort (String unit) 
{ 
itd (unit equals (Ta CoPR2rtS"]]) 
return a CoPortL; 
clsSc oa ce quals (BAICOPATES)) 
return D CoFortb; 
cca DnPcebauabs(i cst oParts')) 
return c CoPortb; 
celsa EDI eus OM BnParts:) /) 
return BhnFPortL; 
else return -1; 
)//end 


PUD er Stavtesimt —GCetocnarorl (String Unit) 
{ 
VEn Ttregqualetamcorarts") .) 
return axCePOrts; 
else Tto(unicregquaàls(" D2e0PXEcS")) 
return DoCOPOPts5; 
else uDIit.eduals('*cocoParts")) 
retuürn C CoOPOrt3S; 
else if (unit equals (il BnPartsi) ) 
return BnPorts; 
else return -1; 
}//end 


f f| Fe ehe ee eee e eee e e e ee ee e ehe ede e ede de ke e he ede de he e e e e e e e ee e e e e he e ec e e e e ee e ee ek 


// End File: portNumbers.java 


f | Fo eee de 4 d 3 4 H de 3 d de de de hehe de d 3 de de de de de de de de de de de de de de de de de de de de de de de de de e dc de de de de he de de de de de ehe de de de K 
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APPENDIX C. RMI JDBC MODEL 


This appendix provides the source code for the RMI implementation. It is 
organized from the graphical user interface, down through the logic modules as depicted 


in the following figure. 


mainFrame 


BasicUser Admin Broker 


passwordDlg acessPanel 
basicFrame genericFrame adminFrame 


dbAdminBroker Int dbBroker Int 








Figure 24 : RMI Object Model 
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The model is implemented as follows: The rmiregistry and object server must be 
started on the remote machine. The object server instantiates and registers the remote 
objects. The client application consists of a mainFrame, and can be started on any 
machine. The mainFrame is an application that has a menu bar with the following 
options: Basic User, Admin, and Broker. 

Under the Basic User option the user can select accounts or navy. A password 
dialog box 1s displayed (1). When the user enters his name and information, it calls the 
remote object, either navy or accounts method getAccessPolicy(2) which returns an 
` access policy object. The access policy object defines an access code, which allows the 
user to get a certain database view (different GUI basic or generic). The intent here is to 
show that policy can reside on the server, yet be enforced on the client. Based upon the 
access code the user may get a genericFrame, or a basicFrame(3). 

The basic frame provides a few high level methods that invoke the remote 
acctsdb Impl object. A basicFrame was not implemented for the navy database. The 
generic frame allow the user to enter a SQL statement and is more appropriate for a 
database administrator. Both frames make remote calls through the accts or navy db 
implementation objects. 

The admin menu option displays the admin Utility Frame. The admin frame 
invokes remote methods provided by dbAdminBroker Impl. This implementation uses 
JDBC to maintain a database of user names, passwords and available data sources. When 
a datasource is going to be made available to the organization, the DBA would create an 
ODBC aliase to the datasource (We used the JDBC-ODBC bridge to provide a generic 
implementation). Then the administrator would enter the datasource into the available 
databases table via the admin utility tool/frame. The admin Frame consists of three 
options: user, access, and admin. The admin panel is used to add datasources to the 
datasource list. The user panel allows the administrator to enter a user name and 
password, and allow that person access, or delete his/her access from the system. The 
access panel is used to authorize users access to specific datasources. 

The broker option from the main application, opens an accessPanel. After the 
user enters his name and password, the panel uses the remote dbAdminBroker Int to 
ensure the client has access to the system and populates a drop down menu with the 
datasources the user has access to. When the user selectes a datasource, it creates a 
brokerSQLFrame, which uses the datasource selected to invoke the setConnection 
method implemented by dbBroker Impl. The user can then perfrom basic database 


manipulation functions. 
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f| f| oe ee de de ee de de de de de Ke de e de e Se de e de Ke de de He de de de H de de de de de de de de de de de K de de de de de de de de H d K e de 


// File: mainFrame.java 
// Purpose: The main window for the application, GUI created 
/ / by Visual Cafe 


] | Kk H K * *% d * * % H K K % d K K d K de K d e ede eoe e e he ee e ode dee e Ke K de de d e de de H de de de de de de e hehe e ee 


import java.awt.*; 
import Java. Ti. //ÉOLC RMI 
HMOOEL java. Utada //for vector 


public class mainFrame extends Frame 
{ 
//remote objects 
static navydbInt navydbServer nu 
Static acctsdbInt acctsdbServer null 
Static accessrolicy Int policy = null; 


//remoteInterface flags 


Static Doolean remoteAcects =Mallise; 
static boolean remoteNavy = false; 
static int accessCode = -1; 


public mainFrame() 

( 
//only need one security manager, 
System.setSecurityManager (new RMISecurityManager ()); 


// This code is automatically generated by Visual Cafe 


//((INIT CONTROLS 

setLayout (null); 

setVisible(false); 

setSize(insets().left + insets().right + 600,insets().top + 
insets().bottom + 400); 

openFileDialogl = new java.awt.FileDialog(this); 

openFileDialogl.setMode (FileDialog.LOAD) ; 

openFileDialogl.setTitle("Open") ; 

//$$ openFileDialogl.move (40,277); 

broker Panel - new java.awt.Panel(); 

Droker Panel cetLayoui (nuri: 

broker Panel.setVisible (false); 

broker Panel. setBoundsinsets():left + 1I2,1ndets 0009: 0155, 579,213)5 

add (beakers Panel); 

labell = new java.awt.Label("User ID:"); 

labell.setBounds (144,24, 99,27); 

DEC ERESNE aad (abel), 

name TF = new java.awt.TextField(); 

NeamewGr. set bounds (2527247150, 25); 

broker Panel.add(name TF); 

label2 - new java.awt.Label("Authorized Access To:"); 

label2.setbounds(96,156,132,27); 

brokeraPaneWMagad(label2); 

dsn Choices - new java.awt.Choice(); 

broker Panel.add(dsn Choices); 

dsn_Choices.setBounds (252, 156,135, 26) ; 

password TF = new java.awt.TextField(); 

Passvorcd fe. SeeBehocCnar(**'); 

password TF.setBounds(252,60,150,25); 
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brokergPanel.add(password TR 

label3 - new java.awt.Label("User Password:"); 
label3.setBounds (144, 60, 96,19); 

broker Panel.add(label3); 

submit Button - new java.awt.Button(); 
submitoButton-setActaqoncommand (Huston nE 

submit Button.setLabel("Submit"); 
SUbDMEEEBUE EON. SCEBOUNGS( 204716775, 20)" 

submit Button.setBackground(new Color (12632256) ); 
broker Panel ,add(submic Button) ; 

cancel Button = new java.awt.Button(); 

cancel Button. setAcientonmana ("DUETO 

cancel Button. setLabel( Cancel"); 

cancel. Button sect Bounds S24 46,715,257, 

€ancel Button. seeBackg round (new (Ce lo males 32725090), 
broker Panel add (cance! Button): 

go Button = new java.awt.Button(); 

go Button-setActienCommane( bULEOm IT 

go Burtonaset Lapedr(tG0 H); 

go Button.setBounds (408,156,40,22); 

go Button. serBackground (new Color (126326) 
brokerprRanel;add\gemButten),; 

statusBar = new java.awt.TextField(); 
statusBar.setBounds(insets().left + 0,insets().top + 372,600,29); 
add (statusBar); 

setTitle("JDBC Remote Method Invocation"); 

EDO 


//( (INIT MENUS 

mainMenuBar - new java.awt.MenuBar(); 

menul - new java.awt.Menu("File"); 

miExit -» new java.awt.MenuItem("Exit"); 
menul.add(miExit); 

mainMenuBar.add(menul) ; 

DataSources = new java.awt.Menu("Administrator”); 
admi_AdminTool = new java.awt.Menultem("Admin Tool”); 
DataSources.add(admi AdminToo!); 
mainMenuBar.add(DataSources); 

menu2 - new java.awt.Menu("Basic User"); 

basicAccts -» new java.awt.MenuItem("Accounts"); 
menu2.add (basicAccts); 

basicUserNavy = new java.awt.MenuItem("Naval Group"); 
menu? .add (basicUserNavy); 

mainMenuBar.add (menu2); 

m Broker — new java.awt.Menu("Broker"); 

broker DataAccess = newrjava.awt.MenuTtem('"Data Access"); 
m Broker.add(broker DataAccess); 

mainMenuBar.add(m Broker); 

menu3 - new java.awt.Menu("Help"); 
mainMenuBar.setHelpMenu (menu3); 

miAbout = new java.awt.Menultem("About..”); 
menu3. add (miAbout) ; 

mainMenuBar.add (menu3) ; 

setMenuBar (mainMenuBar); 

//$$ mainMenuBar.move (4,277); 

LIX 


/7{ (REGISTERS EISTENERS 

SymWindow aSymWindow = new SymWindow(); 
this.addWindowListener (aSymWindow) ; 
SymAction lSymAction -» new SymAction(); 
miAbout.addActionListener(lSymAction); 
miExit.addActionListener(lSymAction); 
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basicUserNavy.addActionListener (1SymAction); 
basicAccts.addActionListener(lSymAction); 

broker DataAccess.addActionListener (1SymAction); 
cancel Button.addActionListener (lSymAction); 
submit Button.addActionListener(1SymAction); 

go Button.addActionListener(lSymAction); 

admi AdminTool.addActionListener (lSymAction); 
LITI 


public mainFrame (String title) 
{ 

this 

setTitle(title); 
) 


public synchronized void show() 


{ 
move (20/50): 
super.show(); 


) 


Static public void main(String args[]) 
{ 


(new mainFrame()).show(); 


) 
public void addNotify() 
( 
// Record the size of the window prior to calling parents addNotify. 
Dimension d = getSize(); 


super.addNotify(); 


if (fComponentsAdjusted) 
recu, 


// Adjust components according to the insets 


setSize(insets().left + insets().right + d.width, insets().top + 
insets() bottom + d.height); 
Component components[] = getComponents (); 


Lor (aint iO e components.length; Irt) 

( 
Point p = eomponents[1).getLocation(); 
p.translate(insets().left, insets().top); 
components[i].setLocation(p); 

) 

fComponentsAdjusted = true; 


// Used for addNotify check. 
boolean fComponentsAdjusted = false; 


//((DECLARE CONTROLS 
java.awt.FileDialog openFileDialogl; 
java-awt.Panel broker Panel; 
java.awt.Label labell; 
java.awt.TextField name TF; 
java.awt.Label label2; 
java.awt.Choice dsn Choices; 
java.awt.TextField password TF; 
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java.awt.Label label3; 
java.awt.Button submit Button; 
java.awt.Button cancel Button; 
java.awt.Button go Button; 
java.awt.TextField statusBar; 
//)) 


//((DECLARE MENUS 
java.awt.MenuBar mainMenuBar; 
java.awt.Menu menul; 
java.awt.MenuItem miExit; 
java.awt.Menu DataSources; 
java.awt.MenuItem admi AdminTool; 
java.awt.Menu menu2; 
java.awt.MenuItem basicAccts; 
java.awt.MenuItem basicUserNavy; 
java. awt Menu m Broker; 
jąáava awt Nenultem broker DataAcceéss; 
java.awt.Menu menu3; 
java.awt.MenuItem miAbout; 

7 48 


class SymWindow extends java.awt.event.WindowAdapter 
{ 
public void windowClosing(java.awt.event.WindowEvent event) 
{ 
Object object = event.getSource (); 
if (object == mainFrame.this) 
Framel WindowClosing (event); 


) 


void Framel WindowClosing(java.awt.event.WindowEvent event) 
{ 
hide (); // hide the Frame 
dispose(); // free the system resources 
System.exit(0); // close the application 
) 


class SymAction implements java.awt.event.ActionListener 


{ 


public void actionPerformed(java.awt.event.ActionEvent event) 
{ 
Object object = event.getSource(); 
if (object == miAbout) 
miAbout_ Action (event); 
else if (object == miExit) 
miExit_Action(event); 


else if (object == basicUserNavy) 
navy Action(event) ; 

else if (object == basicAccts) 
menulteml Action (event); 

else if (object -- broker DataAccess) 
broker Patahccess Action (event). 

else If 7 (objéct i ==”cancel#Buttoen) 
cancelButton_Action (event) ; 

else xf (object == submit Button) 
submitButton Action (event); 

else if (object -- go Button) 
cobButton action (events 

else if (object -- admi AdminTool) 
admiAdminTool Action (event); 
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} 


void miAbout Action(java.awt.event.ActionEvent event) 
{ 

/ / {{CONNECTION 

// Action from About Create and show as modal 

(new AboutDialog(this, true)).show(); 

7400) 
} 


void miExit Action(java.awt.event.ActionEvent event) 
{ 

/ / ( (CONNECTION 

// Action from Exit Create and show as modal 

(new QuitDialog(this, true)).show(); 

DE 
) 


void miOpen Action(java.awt.event.ActionEvent event) 


{ 
/ / ( (CONNECTION 


// Action from Open... Show the OpenFileDialog 
openFileDialogl.show(); 
p) 


) 

//dba selected accounts 
vostdedcctsDBonctI)onmjava.dWE- event.ActronEvent'eventé 
{ 

// Create and show the Frame 
(new genericSQLFrame ("accounts")).show(); 
} 
//dba selected navy 
void navyDB Action(java.awt.event.ActionEvent event) 


{ 


// to do: code goes here. 


// ( (CONNECTION 
// Create and show the Frame 
(new genericSQLFrame ("navy")).show(); 


778.) 


//basic user navy 
void navy Action(java.awt.event.ActionEvent event) 
{ 
//bound to navy server 
remoteNavy = true; 
b1ïndRMTObject  (); 


//{ {CONNECTION 
// Create and show as modal 
(new PasswordDialog(this, true)).show(); 


ZAY) 


//basic user accounts 
void menuIteml_Action(java.awt.event.ActionEvent event) 


( 


remoteAccts = true; 
bindRMIObject(); 
PasswordDialog passDlg = new PasswordDialog(this, true); 


167 


passDlg.show(); 


//open a new basic userframe 
// Create and show the Frame 
(new basicAcctFrame(acctsdbServer)).show(); 
TRA 
) 


PUE static voidelockup(String user, String pw) 
{ 
//get the policy 
if (remoteNavy) { 
try{ 
policy = navydbServer.getAccessPolicy(); 
}catch (RemoteException e) { 
System. cut. printin ("Remote Exception... e); 
) 
) 
else if(remoteAccts)( 
try{ 
policy = acctsdbServer.getAccessPolicy(); 
}catch (RemoteException e) { 
System.out.println("Remote Exception: * + e); 
) 
} 


//get the access code 

accessCode = policy.getAccessCode (user) ; 

//test the policy 

System.out.println(user + " Access Code = " + accessCode); 


if (accessCode == 1)( 
if (remoteNavy) 
(new genericSQLFrame ("navy") ).show(); 
else if (remoteAccts) 
(new genericSQLFrame ("accounts") ).show(); 


)jelse if (accessCode == 2) { 


//show a dialog box stating not autthorized. 
System. out. println("To Do"); 

else 
System.out.println("Not a valid Access Code"); 


) 


Jf BR Fe ee e e e e e e e e e e ke e ke ke ke e e e eoe ke e e ke e ke e ee ke coke e e e de de ke e e ke e e 


// Function -P DInNdRMIODJect() 
// Purpose: Binds client to remote object, allowing client 
n to execute methods defined in the objects interface 
f f| ke ee ede ede % d ee e de de de e e de % K d K K d K e ode ee e e e e %« % % % e ee de de ee % * % * 
public void bindRMIObject() 
( 
EE 


if (remoteNavy) { 
System.out.println("Binding to Remote Navy Data Base..."); 
navydbServer = 
(navydbIint) Naming. lookup ("rmi://131.120.1.91/navydbServer") ; 
}else if (remoteAccts) { 
System.out.println("Binding to Remote Accounts Data Base..."); 
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acctsdbServer = 
lacctsdoine -mng oop ( 'rmi://131.120.1.91/accesdeserver”); 


} 


} catch (NotBoundException e) { 
System.out.println("NotBoundException" + e); 


}catch (RemoteException e) { 
System.out.println("Remote Exception " + e); 


}catch(java.net.MalformedURLException e) { 
System. out.printin(e); 
} 


}//end bindRMIObject 


[LER RRR K K % H 4 he hehe hee je H K K K * e USER SELECTS Broker / DATA ACCESS e c x+ xk xk x x x * x * x * *x * * 
dbAdminBroker Int adminBrokerServer = null; 


TARDE RR RAR ARRE RENTA AAA RARA AA ERA AA RAR AENA 


// Eunction : bindRMTOB ect () 
// Purpose: Binds client to remote object, allowing client 
iy to execute methods defined in the objects interface 
f /[ Fee e ecc ehe de hehe ke ode ee dece e ehe ee e je e e e e de he de ee e Kk KKK KKK KKK KKK kk 
void brokerDataAccess Action(java.awt.event.ActionEvent event) 
{ 
// to do: code goes here. 
//bind with adminBroker 


tryl 


//only need one security manager, so install upon initilization of app 
//System.setSecurityManager (new RMISecurityManager()); 


adminBrokerServer - 
(obAdni ne rokers ine) Naming alookup (“rmi://131.120 717947 adn neaekerServer ); 


} catch (NotBoundException e) { 
System.out.println("NotBoundException" -* e); 


}catch(RemoteException e) { 
System out perntin("Remote Exception “ + e); 


}catch (java.net.MalformedURLException e) { 
System.out.println(e); 


) 


/ / ( (CONNECTION 
// Show the Panel 
broker Panel.setVisible (true); 
0; 
) 


void cancelButton Action(java.awt.event.ActionEvent event) 


{ 


// to do: code goes here. 


//{ {CONNECTION 

// Hide the Panel 

brokers Panel.setvisible (false) ; 
StatusBar.setText (""); 
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} 


nomcecpE setText( ^) 
passworndeEJetrlexcol s 


1.7. 1) 


void submitButton Action(java.awt.evefmWActionEvent event) 


( 


//get user input 
String name = name TF.getText (); 
String password = password TF.getText (); 


//call adminBrokerServer to get database access list 
Vector ans = new Vector /(); 


EEXVI 
ans = adminBrokerServer.getDBAccess (name) ; 
)catch (RemoteException e) ( 
System.out.println(e); 
) : 
Lf (leans saskmpty() j4 


Enumeration enum = ans.elements(); 
while(enum.hasMoreElements() ) { 
String dsn = (String) enum.nextElement (); 


dsnpmehorees adeltem(dsn),; 
}//end while 
}else 
StatusBar.setText ("User is not Authorized Access to any DataBase"); 


24 

/ / ( (CONNECTION 

// Hide the Panel 

//broker Panel.setVisible(false); 
4744 


//user has selected a database to go to 


voiïdijgor|ButtongaAcctionm(javarawt;évent.ActionEventievent) 


( 


} 


// to do: code goes here. 
String choice = dsn Choices.getSelectedItem(); 


//create a genericFrame which will bind to dbBrokerServer 
/ / { {CONNECTION 

// Create and show the Frame 

(new brokerSQLFrame (choice)) .show(); 

ADA 


//clear text fields 

name TE.setText(""); 

password TF.setText (""); 

dsn Choices removeAll; 

/ / ( (CONNECTION 

// Hide the Panel 

Pee een ane loci AS IS ya, 
7:59 


void admiAdmintool Action(Java.awt.event.ActienEvent event) 


( 


// to do: code goes here. 
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/ / ( (CONNECTION 
// Create and show the Frame 
(new Framel()).show(); 
"T 
) 
) 


Uy X oko koX oO ARR RER EN E A A e e A A RE AA 


//end mainFrame.java 
J [BERR ER ER EEK REE KEEEERKEKKNRKKKKKKK KKK EKKAKKEHEEE KE ERE KR Ko 


MO OK koe koe hook EK AAA EE EEA AREER RARER EERE EE ON ND OUR UE 


UA File: basicAcctFrame.java 

// Purpose: A simple frame, that allows client ability to 
/ / enter a new employee into the accts database, 
/ / or retrieve a list of existing employees 

7 GUI implemented with Visual Cafe 


Jf se de e ehe ee hehe ke ehe k eoe ee e eoe eee ee ee de d KK eoe ek ehe ek eh ehe hee he à e e n 
Inport java.rmz."*; 

import java.awt.*; 

import java.util.*; //Stringtokenizer 


public class basicAcctFrame extends Frame 
{ 
acctsdbInt server - null; 
public basicAcctFrame() 
{ 
// This code is automatically generated by Visual Cafe when you add 
// components to the visual environment. It instantiates and initializes 
// the components. To modify the code, only use code syntax that matches 
// what Visual Cafe can generate, or Visual Cafe may be unable to back 
// parse your Java file into its visual environment. 
/7 ( (INIT CONTROLS 
setLayout (null); 
setVisible (false); 
setSize(insets().left + insets().right + 430,insets().top + 
Ensets().bottom — 343); 
newEmployeePanel = new java.awt.Panel(); 
newEmployeePanel.setLayout (null); 
newEmployeePanel.setVisible(false); 
newEmployeePanel.setBounds (insets().left + 108, insets().top + 
86,228,144); 
add (newEmployeePanel); 
tnameTextField = new java.awt.TextField(); 
tnameTextField.setBounds (60,12,120,19); 
newEmployeePanel.add(tnameTextField); 
Groupl 2 new CheckboxGroup(); 
facultyRadioButton - new java.awt.Checkbox("", Groupl, false); 
facultyvPadsoButton.setBounds(72,36,24,] 607 
newEmployeePanel.add(facultyRadioButton); 
labell = new java.awt.Label ("Name"); 
labell.setBounds(12,12,82,20); 
newEmployeePanel.add(labell); 
label2 - new java.awt.Label("Faculty"); 
label2.setBounds(12,306,82,20); 
newEmployeePanel.add(label2); 
insertButton - new java.awt.Button(); 
insertButton.setActionCommand ("button"); 
insertButton.setLabel ("Insert"); 
insertButton.setBounds(132,84,88,23); 
insertButton.setBackground (new Color(126322560)); 
newEmployeePanel.add(insertButton); 
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cancelButton - new java.awt.Button(); 
cancelButton.setActionCommand ("button"); 
cancelButton.setLabel ("Cancel") ; 
cancelButton.setBounds (36, 84,88,23); 
cancelButton.setBackground (new Color (12632256) ); 
newEmployeePanel.add(cancelButton) ; 
employeeListPanel = new java.awt.Panel(); 
employeeListPanel.setLayout (null); 
employeeListPanel.setVisible(false); 
employeeListPanel.setBounds(insets().left + 0,insets().top + 36,415,216); 
add(employeeListPanel); 

employeeViewList = new java.awt.List(0,false); 
employeeListPanel.add(employeeViewList) ; 
employeeViewList.setBounds (36,0,314,160) ; 
okButton = new java.awt.Button(); 
okButton.setActionCommand ("button"); 
okButton.setLabel ("OK"); 

okButton.setBounds (15672168. 62727); 
okButton.setBackground (new Color(12632256)); 
employeeListPanel.add(okButton); 
setTitle("Basic User Account Frame"); 


E n: 


//(( INIT MENUS 

menuBarl - new java.awt.MenuBar(); 

file = new java.awt.Menu("File"); 

exit - new java.awt.MenuItem("Exit"); 
file.add(exit); 

menuBarl.add(file); 

menul - new java.awt.Menu("Views"); 
employeeView - new java.awt.MenuItem("Employees"); 
menul.add(employeeView); 

menuBarl.add (menul) ; 

insert - new java.awt.Menu("Insert"); 
Employee - new java.awt.MenuItem("Employee"); 
insert.add(Employee); 

menuBarl.add(insert); 

setMenuBar (menuBarl); 

//SS menuBarl.move (0,0); 

113) 


//( (REGISTER LISTENERS 
SymWindow aSymWindow - new SymWindow(); 
this.addWindowListener(aSymWindow); 
SymAction lSymAction - new SymAction(); 
exit.addActionListener(lSymAction); 
Employee.addActionListener(lSymAction); 
insertButton.addActionListener(lSymAction); 
employeeView.addActionListener(lSymAction); 
okButton.addActionListener(lSymAction); 
cancelButton.addActionListener(lSymAction); 
171) 

) 


public basicAcctFrame (acctsdbInt server) 


{ 
iria sd 
this.server = server; 


} 


public basicAcctFrame (String title) 


{ 
Ets 
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setTitle(title); 
) 


public synchronized void show() 
{ 

move(50, 50); 

super.show(); 
) 


public vold acdNoet fly () 
{ 
// Record the size of the window prior to calling parents addNotify. 
Dimension d = getSize(); 


super.addNotify(); 


if (fComponentsAdjusted) 
return; 


// Adjust components according to the insets 
setSize(insets().left + insets().right + d.width, insets().top + 
Mnsets() -Dortom * d.herght); 
Component components[] = getComponents(); 
for (int i = 0; 1 € components.length; 1++) 
( 
Point p - components[i].getLocation(); 
p.translate(insets().left, insets().top); 
components [i].setLocation(p); 
} 
fComponentsAdjusted = true; 


// Used for addNotify check. 
boolean fComponentsAdjusted = false; 


//f (DECLARE CONTROLS 
java.awt.Panel newEmployeePanel; 
java.awt.TextField tnameTextField; 
java.awt.Checkbox facultyRadioButton; 
CheckboxGroup Groupl; 
java.awt.Label labell; 
java.awt.Label 1abel2; 
java.awt.Button insertButton; 
java.awt.Button cancelButton; 
java.awt.Panel employeeListPanel; 
java.awt.List employeeViewList; 
java.awt.Button okButton; 


2/19 


//{ {DECLARE MENUS 
java.awt.MenuBar menuBarl; 
java.awt.Menu file; 
java.awt.MenuItem exit; 
java.awt.Menu menul; 
java.awt.MenuItem employeeView; 
java.awt.Menu insert; 
java.awt.MenuItem Employee; 
//}} 


class SymWindow extends java.awt.event.WindowAdapter 


{ 


public void windowClosing(java.awt.event.WindowEvent event) 


{ 
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Object object = event.getSource (); 
if (object == basicAcctFrame.this) 
Framel WindowClosing (event); 


) 


void Framel WindowClosing(java.awt.event.WindowEvent event) 
1 

hide(); // hide the Frame 
) 


class SymAction implements java.awt.event.ActionListener 
{ 
public void actionPerformed(java.awt.event.ActionEvent event) 
( 
Object object - event.getSource(); 
if (object == exit) 
eGxrYEOACETOD eventos 
else if (object == Employee) 
Employee Action (event) ; 
else if (object == insertButton) 
¡NSSETEUELONAA E CIÓN (event); 
else if (object == employeeView) 
employeeView Action (event); 
else if (object == okButton) 
okButton Action(event); 
else if (object == cancelButton) 
cancelButton- Action (event); 


) 


void exit Action(java.awt.event.ActionEvent event) 


{ 
// to do: code goes here. 


/ / {{CONNECTION 
// Hide the Frame 
setVisible(false); 
LAY 

} 


voi gere loye Action Java ant event. ACtIOnEvent event) 


{ 


// to do: code goes here. 


/ / ( (CONNECTION 
// Show the Panel 
newEmployeePanel.setVisible(true); 
"4 

) 


void insertButton-Action(java.awt.event.ActrionEvent event) 
{ 

// to do: code goes here. 

String name - tnameTextField.getText(); 

boolean fac = facultyRadioButton.getState(); 


System. cute primelninlame + " " Tac): 
if (name.equals("")) { 
return; 
} 
bey 


server.insertEmployee (name, fac); 
}catch(RemoteException e) { 
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} 


System.out.println(e); 


/ / ( (CONNECTION 
// Hide the Panel 
newEmployeePanel.setVisible(false); 


1.708 


) 


void employeeView Action(java.awt.event.ActionEvent event) 


( 


String result null; 
//get results 
ery 


result = server.viewEmployees(); 


}catch (RemoteException e) { 


} 


System.out.println(e); 


//process the results 
//print one tuple per line using new line as delimitor 
StringTokenizer tok = new StringTokenizer (result, "in"); 


if(result == null) { 
System Out brintin("No reults found?) 
employeeViewList.addItem("No results were generated"); 


}else{ . 
INT Count = tok.countTokensi):; 
for (int ix = Ll; ix <= Count; 180) 


String tuple = tok.nextToken(); 
employeeViewList.addItem(tuple); 
1/7 fend for 
}//end else 


/ / ( (CONNECTION 
// Show the Panel 
employeeListPanel.setVisible(true); 


1719) 


) 


void okButton Action(java.awt.event.ActionEvent event) 


( 


// Hide the Panel 
employeeListPanel.setVisible(false); 


} 


void (cancelButtontaceron(java.awt.event.Acr tone venerevent) 


( 


// to do: code goes here. 
newEmployeePanel.setVisible(false); 


} 
} 


f| | Fee ee ke ee ee ke e de e oe e de e de de de de ke de e e e te k k e ee ke ke k de ke k ke ke k k Kk k k ke e e ke oe ke ee 


// End File: basicAcctFrame. java 


J [555 > k k k e ke ce ee e e ehe de de ke e de ke ke de ke de de he e ke e de de de K d K K d * K K d K d d K K *% Kk k K $ K Kk K k 


J [EEK r k kk k ke he ke ke de te ke ke hee ehe ke ke ke ke de ke 3 Kk K keke Kk Kk K Kk Kk Kk ke k de de k k de k k Kk k Kk k ke k kk k k k> 


// File: 


genericSQLFrame.java 


// Purpose: A generic frame that displays the database table 


names, and column Names. User enters a SQL query 
and frame displays result set. Constructor accepts 
datasource name, to bind to. 

GUI created by Visual Cafe. 
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f | Kk 3k K * e e e ee e ke e ede ede HE e ede ede e ee ede kc he ehe e he e e e e e de e ede ede de oe te oe oe te oe eke K K 


import javarawtZ*; 
import Wava.rmi.*;  //for remote object binding 


import. java.sql.*;  //for resultSet manipulation 
inport sjava util: //for Vector 
importara io: t) //for sleep function 


import symantec.itools.awt.BorderPanel; 

public class genericSQLFrame extends Frame 

( 
//class scope usage 
dbUtilcdbpUtilities = oull/#/#/fenmprint functions 
//remote objects 
navydbInt navydbServer = null; 
accessPolicy Int Currentrecesseolrcy null; 
acctsdbInt acctsdbServer - null; 


//remoteInterface flags 
boolean accts - false; 
boolean navy = false; 


static StringBuffer Duff = null; 


public genericSQLFrame() 
{ 
//MY CODE 
//create a global dbUtilities tool 
dbUtilities = new dbUtil(); 
buff = new StringBuffer (); 


// This code is automatically generated by Visual Cafe when you add 
// components to the visual environment. It instantiates and initializes 
// the components. To modify the code, only use code syntax that matches 
// what Visual Cafe can generate, or Visual Cafe may be unable to back 
// parse your Java file into its visual environment. 
//((INIT CONTROLS 
setLayout (null); 
setVisible(false); 
sersize(insets().left + insets().r1ight + 650, ,1nsets().top + 
insets eeo com + 30055; 
panell - new java.awt.Panel(); 
panell.setLayout (null); 
paneltb.setBounds(insets().left * 0,:nsets().top * 36,360,906); 
add(panell); 
tableNames - new java.awt.Choice(); 
panell.add(tableNames); 
tableNames.setBounds(25,40,150,25); 
db = new java.awt.Label("Data Base Tables"); 
db.setBounds(48,0,106,20); 
panell.add (db); 
label2 = new java.awt.Label ("Table Column Names"); 
label2.setBounds (192,0,132,23); 
panell.add(label2); 
columnChoices = new java.awt.Choice(); 
panell.add(columnChoices); 
columnChoices.setBounds(192,40,150,25); 
resultSet = new java.awt.List(0,false); 
add(resultSet); 
resultSet.setBeunds(insets()-.lett + 36,insets (top t 168,988,169); 
clearList = new java.awt.Button(); 
clearList.setActionCommand ("button") ; 
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ClearlLise setlabel ("Clear List"); 

clearLise sethoundsiinsets().left + 312,insets() cop + 360,77,27); 

clearList.setBackground (new Color(12632256)); 

add (clearList); 

panel2 = new java.awt.Panel(); 

panel2.setLayout (null); 

panel2.setBounds (insets().left + 360,insets().top + 36,273,108); 

add(panel2); 

labell = new java.awt.Label ("Enter SQL Statement Below"); 

labell.setBounds (24,0,168, 32); 

labell.setForeground(new Color(255)); 

panel2.add(labell); 

sqlStmt = new java.awt.TextField(); 

sqlstmtssetbounds (0,36,264, 25); 

panel2.add(sqlStmt); 

sendSQL = new java.awt.Button(); 

sendSQL.setActionCommand ("button"); 

sendSQL.setLabel ("Submit"); 

sendSQL.setBounds(168,72,76,28); 

sendSQL.setBackground (new Color(12632256)); 

panel2.add(sendSQL); 

clearSQL - new java.awt.Button(); 

clearSQL.setActionCommand ("button"); 

clearSQL.setLabel ("Clear"); 

clearSQL.setBounds (36,72,85,27); 

clearSQL.setBackground(new Color (12632256) ); 

panel2.add(clearSQL) ; 

label3 = new java.awt.Label ("Result Set"); 

label3.setBounds (insets().left + 24,insets().top + 132,96,24); 

add (label3); 

exitButton - new java.awt.Button(); 

exitButton.setActionCommand ("button"); 

exitButton.setLabel("Exit"); 

exitButton.setBounds(insets().left + 312,insets().top + 408,72,23); 

exitButton.setBackground (new Color(16711680)); 

add(exitButton); 

accessCodeTextField = new java.awt.TextField(); 

accessCodeTextField.setBounds (insets().left + 48,insets().top + 
834. 68,26); 

add(accessCodeTextField) ; 

label4 = new java.awt.Label ("Access Code"); 

label4.setBounds(insets().left + 48,insets().top + 360,84,20); 

add(label4); 

setTitle("Navy Data Source"); 


//)) 

//((INIT MENUS 

menuBarl - new java.awt.MenuBar(); 

menul - new java.awt.Menu("File"); 
fileExit - new java.awt.MenuItem("Exit"); 


menul.add(fileExit); 

menuBarl.add (menul); 

menu2 - new java.awt.Menu("Policy"); 
menuIteml - new java.awt.MenuItem("Get Current"); 
menu2.add (menuIteml); 

menuBarl.add (menu?2) ; 

menu3 = new java.awt.Menu ("Users"); 

userAdd - new java.awt.Menuitem("Add User"); 
menu3.add (userAdd) ; 

menuBarl.add(menu3); 

setMenuBar (menuBarl); 

//SS$ menuBarl.move(0,0); 


177) 
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//AWREGISTER. LISTENERS 

SymWindow aSymWindow = new SymWindow(); 
this.addWindowListener (aSymWindow) ; 
SymAction 1SymAction = new SymAction(); 
sendSQL.addActionListener(lSymAction); 
clearList.addActionListener (lSymAction); 
Symitem 1SymItem = new SymItem(); 
tableNames.addItemListener(lSymItem); 
clearSQL.addActionListener(l1SymAction); 
exitButton.addActionListener(l1SymAction); 
fileExit.addActionListener(lSymAction); 
menuIteml.addActionListener(lSymAction); 
userAdd.addActionListener(lSymAction); 
eS 


J h 55 5 r He k de de de de de de de de de de de de de de de de k de de k de k de k de de de de e k de de de kk k ke dek k k e de k e e e 


// Function: genericSoLFrame(String dsi) 
// Purpose: Constructor, uses dsn to bind to remote object, 
Ly get the database table names, and update frame title 
f f| Fee e che e dece de dede eee e e e e e e hee e de dede de de de che ede ve de e e de hehe e ede eode e ke e e 
public genericSQLFrame(String dsn) 


{ 
this(); 


if( dsn.equals ("navy") ) { 
setTitle("Naval Support Group Data Base"); 
this.navy = true; 


} 

else if( dsn.equals("accounts")){ 
setTitle("Accounts Data Base”); 
this.accts = true; 

) 

//bind to remote object 

bindRMIObject(); 


//update database table drop down 
getDataBaseTables(); 


} 


JI ERRATA RARE RAE eoe OK OK e e ORC oO e lee 


// Function: getDataBaseTables (String remoteObj) 
// Purpose: Based upon remoteOjb communicating with 
PETER TAI OK c KK Wok OK UOCE OX Kee koe XO Ko RO A oe 


public void getDataBaseTables () 
{ 


Vector ans = new Vector(); 
try{ 
if (navy) { 
ans = navydbServer.getTableName (); 
} 
else if(accts) { 
ans = acctsdbServer.getTableName(); 
} 
}catch(RemoteException e) { 
System.err.println(e); 


} 
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Enumeration enum = ans.elements(); 

while (enum. hasMoreElements() ) { 
String name = (String)enum.nextElement(); 
//update the tableNames 
tableNames.addItem(name); 


) 
)//end getDataBaseTables 


public void updateColumnList(String tableName) 


( 
columnChoices.removeAll(); //clear the column choice object 


if(tableName !- null)( 
StringBuffer Duff = new StringBuffer("SELECT. "FROM? 
buff.append(tableName); 


String sql = new String(buff); 
Vector colVect = new Vector(); 
tryi 
if (navy) { 
colVect = navydbServer.getTableMetaData (sql); 
}else if (accts) { 
colVect = acctsdbServer.getTableMetaData (sql); 
} 
}catch(RemoteException e) { 
System.out.println(e); 
) 
//now update colChoiceBox 
Enumeration enum - colVect.elements(); 
while(enum.hasMoreElements() ) { 
String name = (String)enum.nextElement(); 
//update the tableNames 
columnChoices.addItem(name); 


) 


1//end, function 


Lf RRAERAAR AER ER KE RARE BEEK KERR ER EE RRR ERR RRR oR c 


Atencion bXDndRMIObject (0 

// Purpose: Binds client to remote object, allowing client 

i to execute methods defined in the objects interface 
RS ER RK RARE EAE KE ERK RR EEE A ee 

public void bindRMIObject () 


{ 
tryl 


if (navy) { 
System.out.println("Binding to Remote Navy Data Base..."); 
navydbServer = 
mavydabInt)Naming.lookup("rmi://131.120.1.91/navydbServer”); 


jelse if(accts)!{ 
System.out.printin("Binding to Remote Accounts Data Base..."); 


acctsdbServer = 
facctsdbint) Naming. lookup ("rmi://131.120.129)/acctsdbServer") ; 


} 


} catch (NotBoundException e) { 
System.out.println("NotBoundException" + e); 


}catch(RemoteException e) { 
System.out.println("Remote Exception " + e); 
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)catch(java.net.MalformedURLException e)í( 
System.out.println(e); 


) 


)//end bindRMIObject 


public synchronized void show() 


{ 


move (50, 50); 
super.show(); 


) 


public void addNotify() 


{ 


// Record the size of the window prior to calling parents addNotify. 
Dimension d = getSize(); 


super.addNotify(); 


YE 


(fComponentsAdjusted) 
returni 


// Adjust components according to the insets 

setSize(insets().lëft + insets().right da width, ansets().top + 
insets (0 bottom d. .heignt); 

Component components[] = getComponents (); 


LOL 


( 


) 


(int i = 0; i < components. length; i++) 


Point p = components[i].getLocation(); 
p.translate(insets().left, insets().top); 
components [i].setLocation(p); 


fComponentsAdjusted = true; 


} 


// Used for addNotify check. 
boolean fComponentsAdjusted = false; 


// ( (DECLARE, CONTROLS 


java. 
java. 
java. 
java. 
java. 
java. 
java. 
ant. 
awt. 
awt. 
awt. 
„Button clearSOL; 


java 


java. 
java. 
java. 
java. 
java. 
java. 
java. 
java. 


ji 


awt. 
.Choice tableNames; 


awt 


awt. 
awt. 
awt. 
awt. 
.Button clearList;: 


awt 


awt 


awt. 
.Button exitButton; 
-TextField accessCodeTextField; 


awt 
awt 


awt. 


Panel panell; 


Label db; 

Label label2; 

Choice columnChoices; 
List resultSet; 


Panel panel2; 
Label labell; 
TextField sqlStmt; 
Button sendSQL; 


Label label3; 


Label label4; 


//{{DECLARE MENUS 
java.awt.MenuBar menuBarl; 
java.awt.Menu menul; 
java.awt.Menultem fileExit; 
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java.awt.Menu menu2; 
java.awt.MenuItem menulteml; 
java.awt.Menu menu3; 
java.awt.Menultem userAdd; 
LANA 


class SymWindow extends java.awt.event.WindowAdapter 
{ 
public void windowClosing(java.awt.event.WindowEvent event) 
{ 
Object object = event.getSource(); 
if (object == genericSQLFrame.this) 
Framel WindowClosing (event); 


} 


void Framel WindowClosing(java.awt.event.WindowEvent event) 
( 

hide(); // hide the Frame 
) 


class SymAction implements java.awt.event.ActionListener 
{ 
public void actionPerformed(java.awt.event.ActionEvent event) 
{ 
Object object = event.getSource(); 
if (object == sendSQL) 
sendSQL Action (event) ; 
else if (object == clearList) 
clearList Action (event); 
else if (object == clearSQL) 
clearSQOL Action(event); 
else if (object -- exitButton) 
exitbutrtontaction(event); 
else if (object == fileExit) 
tileBxitiacción (event); 
else if (object == menulteml) 
menutTtemiIndetion(event); 
else if (object == userAdd) 
userAdd Action(event); 


) 


f f| Ne eoe e ehe ee ehe ede ede Kk K ï % k K 3 *% k 3 k 3 k k RRA ARA ARA x 


// Function : sendSOL Action 


// Purpose: User has entered a SOL statement and hit the send button 
D Gets the result set and displays it in the result list 


f /[ x ke e ee eee eee kK RR Kk Ke ee ee K K d K d K d K K d % K *% d e ehe ee e ke ee e ek 


pordesendsobeActiomüyava.awteevent.Actronsventoevent) 


{ 
String sql = sqlStmt.getText();//get the statement 


pos 
String result = new String(); 


if(navy) { 

result = navydbServer.executeSOQLGetString (sql); 
else if(accts) { 

result = acctsdbServer.executeSQLGetString(sql); 
} 


//print one tuple per line using new line as delimitor 
StringTokenizer tok = new StringTokenizer(result, "\n"); 
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if(result == null) { 
System.out.println("No reults found"); 
jelse{ 
int count = tok.countTokens(); 
for (int 1x E Is I <è coumes Ldr) 4 
String tuple = tok.nextToken(); 
resultSet.addItem(tuple); 
)//end for 
)//end else 


}catch (RemoteException e) { 
System.out.println(e); 


) 
//clear the sql statement text box 


sq lStmt.setText (' 2); 
}//end func 


void clearList_Action(java.awt.event.ActionEvent event) 


( 
resultSet.removeAll(); 


}//end clearList 


class SymItem implements java.awt.event.ItemListener 


{ 


public void itemStateChanged(java.awt.event.ItemEvent event) 


{ 
Object object = event.getSource(); 
if (object == tableNames) 
tableNames ItemStateChanged (event) ; 


} 


f f| FCR ee ke e e e ke dc de de ke e de de de de de de de de de de de de de de de de de de ke de de ke de de de de ke ee ke ee ke K Xe 


// Function: tableNames Action Handler 
// Gets the item selected from choice box and updates teh column choice box 


JA | Foe ee ee de de de de de de de de de d de de de de de d de de de de de e de de de de de de H de de de de de de de de de de de de de K K 


Vom tab lLeNames tens tarethangedi( java-awt. eventeitemeventWevent) 


{ 


String item = tableNames.getSelectedItem() ; 
updateColumnList (item) ; 


} 


void clearSQL Action(java.awt.event .ActionEvent event) 
{ 


// Clear the text for TextField 
sqlStmt.setText(""); 
} 
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// Function: exit Button Action 
f f kk e ee ke ke de de de de de de K K K de e ke e de K de k k Kk k de k Kk Kk Kk Kk de Kk K % % % k 


void exitButton Action(java.awt.event.ActionEvent event) 
{ 
if (navy) 
mainFrame.remoteNavy - false; 
else if(accts) 
mainFrame.remoteAccts - false; 
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hide (); // hide the Frame 
dispose); // free the system resources 
) 


void fileExit Action(java.awt.event.ActionEvent event) 
{ 
if (navy) 
mainFrame.remoteNavy 
else if(accts) 
mainFrame.remoteAccts = false; 


false; 


Adele // hide the Frame 
dispose(); // free the system resources 
} 


void menuIteml Action(java.awt.event.ActionEvent event) 


{ 


LE (navy). 
try 
currentAccessPolicy = navydbServer.getAccessPolicy(); 
System.out.println("Got new Policy"); 
}catch (RemoteException e) { 
System.out.println("Remote Exception: " + e); 
) 
) 
String user - "basic"; 
int accessCode = currentAccessPolicy.getAccessCode (user); 
accessCodeTextField.setText (String.valueOf (accessCode) ); 


//test the policy 
System.out.println(user + " Access Code = " + accessCode) ; 


AA 
) 


void userAdd Action (java.awt.event.ActionEvent event) 


( 


// Create and show as modal 
(new newUser (this, true)) .show(); 


StringTokenizer tok = new StringTokenizer (buff.toString()); 


String7uid.= tok.nextroken (); 
String pass = tok.nextToken(); 
String dsn = tok.nextToken(); 


if(dsn.equals ("navy") ) { 
//add user to navy accessList 


) 
else if(dsn.equals("accts") )( 


) 
) 


)//end class 
[ [*k*k*k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k K eoe ee k e k k k k e kk ck kk kk kk ek 


ZY END: genericSQLFrame.java 


[[*k*k*k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k x x k k k k K k k x 
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// File: adminFrame.java 
// Purpose: An administrator frame, to enter new users, 
Y provide them database access, and to enter 
"ri new datasources. 


| [| kk hee hehe ke che he de dece de dede he de hehehe ehe de de Se de de he Se de he Se e e de he dede de he e de e e dc de de Se de dede Se de de de ke de che ee dee de hee He 


import java.awt.*; 


public class adminFrame extends Frame 
( 
public adminFrame () 


{ ; 
// This code is automatically generated by Visual Cafe when you add 


// components to the visual environment. It instantiates and initializes 
// the components. To modify the code, only use code syntax that matches 
// what Visual Cafe can generate, or Visual Cafe may be unable to back 
// parse your Java file into its visual environment. 
//((INIT CONTROLS 
setLayout (null); 
setSize(insets().left + insets().right + 430,insets().top + 

insetisi) bottom + 2707 
Setritle({Umereled"); 
LH) ) 


//((INIT MENUS 
17V) 


//((REGISTER LISTENERS 
SymWindow aSymWindow - new SymWindow(); 
this.addWindowListener (aSymWindow) ; 
LAT 

) 


public adminFrame (String title) 
( 

EnYS(); 

setTitle(title); 


) 


public synchronized void show() 


{ 
mowe(50, 20); 
super.show(); 


} 


public void addNotify() 


{ 
// Record the size of the window prior to calling parents addNotify. 


Dimension d = getSize(); 
super.addNotify(); 


if (fComponentsAdjusted) 
return, 


// Adjust components according to the insets 

setSize(insets().left + insets().right + d.width, insets().top + 
insets()\.bottom + d.height); 

Component components[] = getComponents(); 

for (int i = 0; 1. < components.length; 1++) 


( 
Point p = components[i].getLocation(); 
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p.translate(insets().left, insets().top); 
components [i].setLocation(p); 


) 


fComponentsAdjusted = true; 


// Used for addNotify check. 
boolean fComponentsAdjusted = false; 


//( (DECLARE. CONTROLS 
//)) 


//{ {DECLARE MENUS 
ZA 


class SymWindow extends java.awt.event.WindowAdapter 
{ 
public void windowClosing(java.awt.event.WindowEvent event) 
{ 
Object object = event.getSource(); 
if (object == adminFrame.this) 
Framel WindowClosing (event) ; 


} 


void Framel WindowClosing(java.awt.event.WindowEvent event) 
{ 
hide); // hide the Frame 
} 
} 


f| f| FOE k k k k k k k k k kx x k k k x k k k x k x x k k k xk k k k x k k k k k k x x x k k x x k X k x k k kx x x x k x x x %* * X x * 


47⁄7 END: adminFrame.java 


[[tkk*k*k k k kx k k k k x kx k x kx k x x k k k k k k k k x k x k x k k k k x k k k %x x x k x k x k k k x % k x k k k k k e X * x e ke 


[[*k*k*k k k k k k k k k x k k k k x k k x k k k k k k k x k k x x x k k k x k x k k x x k x k e x x k k k k % k k e ke e k k x x % * x x 


yy File: brokerSQLFrame.java 

// Purpose: A generic frame that can be bound to any ODBC datasource. 
104 The constructor accepts a string which is used to establish 
/ / JDBC-ODBC connection, via the dbBrokerImplementation 


[[*k*k*k e k k k x k k k k k k k k k e e e k % e k x % k k %x k x k % k k k e x k ke % ke e ke e e e ke k e e ke e e k ke x k k x e Xe 


import java.awt.*; 

import java.rmi.*; //for remote object binding 
import java.sql.*; //for resultSet manipulation 
Enport java.util.*; //for Vector 

import java.io.*; "tor sleep function 

import symantec.itools.awt.BorderPanel; 


public class brokerSQLFrame extends Frame 
{ 
//class scope usage 
ADUETIMAENEMEETesS suu; //for print functions 
//remote objects 
deBroker Int server — null; 


public brokerSQLFrame () 

{ 
//MY CODE 
//cxeate a global dbUtilities tool 
dbUtilities - new dbUtil(); 
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// This code is automatically generated by Visual Cafe when you add 

// components to the visual environment. It instantiates and initializes 

// the components. To modify the code, only use code syntax that matches 

// what Visual Cafe can generate, or Visual Cafe may be unable to back 

// parse your Java file into its visual environment. 

//((INIT CONTROLS 

setLayout (null); 

setVisible(false); 

setSize(insets().left + insets().right + 650,insets().top + 
insets () .bottom + 500); 

panell = new java.awt.Panel (); 

panell.setLayout (null); 

panell.setBounds(insets().left + 0 insets(]. top t 36,3607 96); 

add (banel11); 

tableNames - new java.awt.Choice(); 

paneil.add(tableNames); 

tableNames.setBounds (25,40,150,25); 

db - new java.awt.Label("Data Base Tables"); 

db.setBounds(48,0,106,20); 

panell.add(db); 

label2 = new java.awt.Label ("Table Column Names"); 

label2.setBounas(192,0,132,23)% 

panell.add(label2); 

columnChoices - new java.awt.Choice(); 

panell.add(columnChoices); 

eolumnChoices.setBounds (192,40, 150,25); 

resultSet = new java.awt.List(0, false); 

add (resultSet); 

resultsSet setBounds(insets().lert -* 36,insets().top + 168,566,169); 

clearList = new java.awt.Button(); 

ClearList.setActionCommand ("button"); 

clearList.setLabel("Clear List”); 

clearhist.setBounds(insets().left + 312 ,insets().top + 360,77,27); 

clearList.setBackground(new Color(12632256)); 

add (clearlList); 

panel2 - new java.awt.Panel(); 

panel2.setLayout (null); 

panel2.setBounds (insets().left + 360,insets().top + 36,273,108); 

add (panel2); 

labell = new java.awt.Label ("Enter SQL Statement Below”); 

labell.setBounds (24,0,168, 32); 

labell.setForeground(new Color(255)); 

panei2.add(labell); 

sqiStmt = new java.awt.TextField(); 

SglStmt.setpounads (0, 36,264, 25), 

panel2. add(sg1Stmt) ; 

sendSQL = new java.awt.Button(); 

sendSQL.setActionCommand ("button"); 

sendSQL.setLabel("Submit"); 

sendSQL.setBounds (168,72,76,28); 

sendSQL.setBackground (new Color(12632250)); 

panei2.add(sendSQL); 

ClearSQL = new java.awt.Button(); 

clearSQOL.setActionCommand ("button"): 

clearSQL.setLabel ("Clear"); 

clearSOL.seiBounds(36,72,05,27); 

clearSQL.setBackground (new Color(12632256)); 

panel2.add(clearSQL); 

label3 = new java.awt.Label ("Result Set"); 

label3.setBounds (insets().left + 24,insets().top + 132, 96,24); 

add (label3); 
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exitButton 


exitButton. 
exitButton. 
exitButton. 
exitButton. 


= new java.awt.Button(); 

setActionCommand ("button") ; 

setlLabel ("Exit"); 

setBounds(insets().left + 312,insets().top + 408,72,23); 
setBackground (new Color(16711680)); 


add (exitButton); 
setTitle("Navy Data Source"); 


//}} 


//{{INIT_MENUS 


menuBarl - new java.awt.MenuBar(); 
menul - new java.awt.Menu("File"); 
fileExit - new java.awt.MenuItem("Exit"); 


menüul.add(fileéëExiït)  ; 
menuBarl.add (menul) ; 
setMenuBar (menuBarl); 
//S$$ menuBarl.move(0,0); 


17) 


//{{REGISTER LISTENERS 

SymWindow aSymWindow = new SymWindow() ; 
this.addWindowListener (aSymWindow) ; 
SymAction 1SymAction = new SymAction(); 
sendSQL.addActionListener(lSymAction); 
clearList.addActionListener (1SymAction) ; 
SymItem lSymItem - new SymItem(); 


tableNames. 


addItemListener(lSymItem); 


clearSQL.addActionListener(lSymAction); 


exitButton. 


addActionListener (1SymAction) ; 


fileExit.addActionListener(1SymAction); 


Jp) 


) 
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17⁄ Function: 


genericSQLFrame (String dsn) 


// Purpose: Constructor, uses dsn to bind to remote object, 
Tey get the database table names, and update frame title 


] | FK ke ee ee e de de de de de de de ee de de e e e e % de de ke ke ee de ke de ke de ee H ke de de ke de ke ke % 


public brokerSQLFrame(String dsn) 


{ 
ais e 


setTitle(dsn); 


//bind to remote object 


try{ 


SyStem.out-printin( Binding to dbBroker ondas 


Server 


(ABBroker_Int)Naming.lookup("rmi://131.120.1.91/dbBrokerServer”) ; 


) catch (NotBoundException e) ( 
System.out.println("NotBoundException" + e); 


}catch (RemoteException e) { 
System.out.println("Remote Exception " + e); 


}catch(java.net.MalformedURLException e) { 
System. our -printinie); 


} 


//create a connection 


try{ 
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US Ir 


Server.createConnection(dsn, 
}catch (RemoteException e) { 
System. out .printintTe): 
} 


//update database table drop down 
getDataBaseTables(); 
) 
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// Function: getDataBaseTables(String remoteObj) 

// Purpose: Based upon remoteOjb communicating with 
[FERRAN ARA A 
public void getDataBaseTables() 

{ 


Vector ans = new Vector(); 


CEA 
ans = server.getTableNames (); 


}catch (RemoteException e) { 
System.err.println(e); 


} 


Enumeration enum - ans.elements(); 
while(enum.hasMoreElements() )( 
String name = (String)enum.nextElement (); 
//update the tableNames 
tableNames.addItem(name); 


) 


)//end getDataBaseTables 


f |] Nee ee de ee ehe de K d * ke de ke K *% K K de *% d d d dc K de d dc d d K d K d e d K 3 e K $ K 3 3 $ ke kk 


// Function: updateColumnList(String tableName) 
// Purpose: Based upon remoteOjb communicating with 
] | E ke ke ee ee e he ehe ehe ehe H de de dc d de e K Se de de de Se Se de de de dc de de de Se de de Hd de de de K de de de d d $ 


public void updateColumnList (String tableName) 
( 


columnChoices.removeAll(); //clear the column choice object 


if(tableName != null)( 


StringBuffer buff = new StringBuffer ("SELECT * FROM "); 


buff.append(tableName); 


String sqle— new String(buft); 
Vector colVect = new Vector(); 
Cry. 
colVect = server.getTableMetaData(sql); 
}catch (RemoteException e) { 
System. out. printinie); 
} 
//now update colChoiceBox 
Enumeration enum = colVect.elements(); 
while(enum.hasMoreElements() ){ 
String name = (String)enum.nextElement (); 
columnChoices.additem(name) ; 


} 


}//end function 
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public synchronized void show() 
( 

move (50, 50); 

super .show():; 


) 


public void addNotify () 
{ 
// Record the size of the window prior to calling parents addNotify. 
Dimension d = getSize(); 


super.addNotify(); 


if (fComponentsAdjusted) 
return; 


// Adjust components according to the insets 
Setcizemnsers().left + insets(}.right + d;width, insets(). top + 
insets().bottom + d.height); 
Component components{] = getComponents(); 
Lore unr 1 > 071 < components: length; Iri) 
( 
Point p = components{i].getLocation(); 
p.translate(insets().left, insets().top); 
components [i].setLocation (p); 
} 
fComponentsAdjusted = true; 


} 


// Used for addNotify check. 
boolean fComponentsAdjusted = false; 


// { (DECLARE CONTROLS 
java.awt.Panel panell; 
java.awt.Choice tableNames; 
java.awt.Label db; 
java.awt.Label label2; 
java.awt.Choice columnChoices; 
java.awt.List resultSet; 
java.awt.Button clearList; 
java.awt.Panel panel2; 
java.awt.Label labell; 
java.awt.TextField sqlStmt; 
java.awt.Button sendSQL; 
java.awt.Button clearSQL; 
Java.awt.Label label3; 
java.awt.Button exitButton; 
173) 


//( (DECLARE MENUS 
java.awt.MenuBar menuBarl; 
java.awt.Menu menul; 
java.awt.Menultem fileExit; 


zr) 


class SymWindow extends java.awt.event.WindowAdapter 


{ 


public void windowClosing(java.awt.event.WindowEvent event) 


{ 
Object object = event.getSource(); 
1f (object == brokerSQLFrame.this) 
Framel WindowClosing (event); 
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} 


void Framel WindowClosing(java.awt.event.WindowEvent event) 


{ 
Hiden. // hide the Frame 


} 


class SymAction implements java.awt.event.ActionListener 


{ 
public void actionPerformed(java.awt.event.ActionEvent event) 


{ 
Object object = event.getSource(); 
if (object == sendSQL) 
sendSQL Action (event); 
else if (object == clearList) 
celearList AcElon(event); 
else if (object -- clearSQL) 
eléarSChpActiouvevent); 
else if (object == exitButton) 
exïtButtonmAction(evént); 
else if (object == fileExit) 
fileExic Aceion (event); 


} 
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// Function TsendSoL Action 


// Purpose: User has entered a SOL statement and hit the send button 
72 Gets the result set and displays it in the result list 


JO Roe ceci ER ER e olo se de ok oe e e e esee KORR OK Se eoe ok ve ke ke EORR OK OR ele ROW OUR 
void sendSOb Action(jJava.awt.event.ActlonEvent event) 


{ 
String sql = sqlStmt.getText();//get the statement 


try{ 
String result = new String (); 


result = server.executeSOLGetString (sql); 


//print one tuple per line using new line as delimitor 
StringTokenizer tok = new StringTokenizer(result, "\n"); 


if (result == null) { 
Svecem out Pprintln("No reults found); 
jelse!{ 
int count = tok.countTokens(); 
FORTE Lx =) Ï; ix <= count; ix++)1! 
String tuple = tok.nextToken(); 
resultSet.addItem(tuple); 
}//end for 
}//end else 


}catch (RemoteException e) { 
SYSEEM.CuL-printin(e); 


} 
//clear the sql statement text box 


sqlStmt.setText(""); 


by fendeLunc 
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// Function: clearList Action (java.awt.event.ActionEvent event) 
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// Purpose: 


PR A ET ERA AAA ARA RA Kc cle Y 


void clearList Action(java.awt.event.ActionEvent event) 


{ 


resultSet.removeA11(); 
1/ /endvcleacluse 


class SymItem implements java.awt.event.ItemListener 


{ 


public void itemStateChanged(java.awt.event.ItemEvent event) 


{ 
Object object = event.getSource(); 
if (object == tableNames) 
tableNamesmitemSstateChanged (event); 


) 


A A e Ed IR a e E 


7/7 Function: tableNames Action Handler 


// Gets the item selected from choice box and updates teh column choice box 
O A A 


void tableNames ItemStateChanged(java.awt.event.ItemEvent event) 
{ 


String item - tableNames.getSelectedItem(); 
updateColumnList (item); 


void clearSQL Action(java.awt.event.ActionEvent event) 


{ 


AI Clear the text for TextField 
sqiStmt.setText(""); 


[ [kkk coe k e k k k k k k k k Kk k e k k k k e k K Kk k k k * Kk K k e k K k K K x x 


//FERnEtIOn: exit BUCEON Action 
J [BRR RK KR ek ek ee ee ee eee ee ek ee ek ke k ke * k k e k e 


void exitButton Action(java.awt.event.ActionEvent event) 


{ 
hide): // hide the Frame 
dispose (); // free the system resources 


sorda Eterna cion” pararawt. event. ActionEyent event) 


{ 


hide () ; // hide the Frame 
dispose (); // free the system resources 


f [k k 3 Kk *k % Kk *% K 3 dee K Kk 3k Kk Kk * Kk e e k e ce ce % 3k *% k K Kk Kk Kk k K K 3 e % K d d e ee Kk e e e K Kk k Kk Kk k K K K d d * d % ke eo 


// END: brokerSQLFrame.java 


f f ECCE *k k k *k * e k eoe * Kk k de % k A k Kk k k k k k k K k k Kk k k k Kk k Kk k k he k de k e Kk K k ke ke k ke k k k Kk k k % % e ke k k k 
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j/ File: newUser.java 
// Purpose: A dialog box to enter a new users name and password, 


Calls back to static function in genericSQLFrame 


f f| E CK ce e k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k Kk k k esce ese dee k ke ke k k k k k k k k Kk k k x e % 
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Import dava dwWt 5. 
import symantec.itools.awt.util.dialog.ModalDialog; 


public class newUser extends ModalDialog 


{ 


public newUser (Frame parent, String title) 


{ 


super (parent, title); 


// This code is automatically generated by Visual Cafe when you add 

// components to the visual environment. It instantiates and initializes 
// the components. To modify the code, only use code syntax that matches 
// what Visual Cafe can generate, or Visual Cafe may be unable to back 
// parse your Java file into its visual environment. 

// ( (INTTZCONTROLS 

setLayout (null); 

setVisible (false); 

setSize(insets().left + insets().right + 215,insets().top + 


insets().bottom + 159); 


} 


setBackground (new Color (2632256) ); 

nameLabel = new java.awt.Label ("Name:"); 
nameLabel.setBounds(insets().left + 12,insets().top + 12,60,15); 

add (nameLabel); 

passwordLabel - new java.awt.Label("Password:"); 
passwordLabel.setBounds (insets().left + 12,insets().top + 48,72,15); 
add (passwordLabel); 

userTextField - new java.awt.TextField(1); 
userTextField.setBounds(insets().left + 84,insets().top + 12,100,22); 
add (userTextField); 

passTextField - new java.awt.TextField(1); 
passTextField.setEchoChar('*'); 
passTextField.setBounds(insets().left + 84,insets().top + 48,100,22); 
add (passTextField); 

okButton = new java.awt.Button(); 

okButton.setLabel("OK"); 

okBuytton.setBounds(insets():left + 84,insets()ztop + 132,40,20) ; 

add (okButton); 

dsnTextField = new java.awt.TextField(); 
dsnTextField.setBounds(insets().left + 84,insets().top + 84,96,21); 
add (dsnTextField); 

labell - new java.awt.Label("Data Source"); 
labell.setBounds(insets().left + 0,insets().top + 84,72,15); 

add (labell); 

setTitle("Add a DataBase User"); 

//)) 


//((REGISTER LISTENERS 

SymAction lSymAction - new SymAction(); 
okButton.addActionListener (lSymAction); 
ZLY) 


public newUser (Frame parent) 


{ 


} 


this(parent, "Username/Password"); 


// Add a constructor for Interactions (ignoring modal) 
public newUser(Frame parent, boolean modal) 


{ 


this (parent); 
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} 


// BAG ameenserictor for Interactions (ignoring modal) 
public newUser (Frame parent, String title, boolean modal) 
{ 

this (parent, title); 
} 


public String getUserName () 
{ 
return userTextField.getText(); 


) 


public String getPassword() 
{ 
return passTextField.getText(); 


) 


public void setUserName (String name) 
{ 
userTextField.setText (name); 


} 


public void setPassword (String pass) 
( 

passTextField.setText (pass); 
) 


public void addNotify() 
( 
// Record the size of the window prior to calling parents addNotify. 
Dimension d = getSize(); 


super.addNotify(); 


if (fComponentsAdjusted) 
Be eon, 


// Adjust components according to the insets 
SGeSizeinseres ().lett + insets().right + d.width, insets () top + 
masets().pettem + a-nergnt) ; 

Component components[] = getComponents(); 

for (int i = 0; i < components.length; i++) 

{ 
Point p = components [i] .getLocation(); 
p.translate(insets().left, insets().top); 
components[i].setLocation(p); 

} 


fComponentsAdjusted = true; 


// Used for addNotify check. 
boolean fComponentsAdjusted = false; 


//{{DECLARE CONTROLS 
java.awt.Label nameLabel; 
java.awt.Label passwordLabel; 
java.awt.TextField userTextField; 
java.awt.TextField passTextField; 
java.awt.Button okButton; 
java.awt.TextField dsnTextField; 
java.awt.Label labell; 

//}} 


198 


class SymAction implements java.awt.event.ActionListener 
{ 
public void actionPerformed(java.awt.event.ActionEvent event) 
{ 
Object object = event.getSource(); 
if (object == okButton) 
cCkButrongeceremievent)? 


} 


void okButton Action(java.awt.event.ActionEvent event) 
{ 

// to do: code goes here. 

String uid = getUserName (); 

String pass - getPassword(); 

String dsn = dsnTextField.getText(); 


System.out.println(uid 4 " " 4 " "ui! um 


genericSQLFrame.buff.append(uid); 
genericSQLFrame.buff.append(" "); 
genericSQLFrame.buff.append (pass); 
genericSQLFrame.buff.append(" "); 
genericSQLFrame.buff.append (dsn); 
genericSQLFrame.buff.append(" "); 


//get rid of box 
hide(); 
dispose(); 


/ / ( (CONNECTION 

// Disable the Button 
//okButton.setEnabled(false); 
IX 


} ` 
[ [”k*k*k*k k k k k k k k k kx k k x k k k k k k % k k k x % % k k * k Kk à k ke k % % k d d k H K e k dH d K $ k k d d d RH A d K K Xe 


// END: newUser.java 
f| f| NR k k k k k k k k k k k e k k k k k k k k ke k k k k e e k k k k k x k e % k % k k * % k k k e de e ke e k d ke k e e e e e e kk 


f| f| Ue k k k k k k k k k k k k k k k k k e k k % k X k k k k k k k k k % k k K *« k d e e de k * ke tee H K Kk H K d k k H k d % ke e e 


77 Eile: passwordDialog.java 
// Purpose: A dialog box to enter a users name and password, 
ry Calls back to static function (lookup(uid, pw) in mainFrame 


[[*ktkkk*k*k k k k k k x k e % k k k k k kx ee ee k k k k % % k % k k x esee Kk * d %* % d % * d e ee RARA RARA ARA 


import java.awt.*; 
import symantec.itools.awt.util.dialog.ModalDialog; 


public class PasswordDialog extends ModalDialog 
{ 
public PasswordDialog(Frame parent, String title) 


( 


super (parent, title); 


// This code is automatically generated by Visual Cafe when you add 

// components to the visual environment. It instantiates and initializes 
// the components. To modify the code, only use code syntax that matches 
// what Visual Cafe can generate, or Visual Cafe may be unable to bacx 
// parse your Java file into its visual environment. 
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//{{INIT_CONTROLS 

setLayout (null); 

setVisible(false); 

SetSize1insets() ..6€£Lt + insets().right + 215,4gsers(). top + 
2usets().bobcom uso 

setBackground (new Color(12632256)); 

nameLabel = new java.awt.Label ("Name:"); 

nameLabel.setBounds (insets().left + 10,insets().top + 32,75,15); 

add (nameLabel) ; 

passwordLabel - new java.awt.Label("Password:"); 

passwordLabel.setBounds(insets().left + 10,insets().top + 60,75,15); 

add(passwordLabel); 

userTextField = new java.awt.TextField(1); 

userTextEleld. setBounds (insets () .1left + 85,insets()-teop * 28,100,22); 

add(userTextField); 

passTextField = new java.awt.TextField(1); 

passTextField.setEchoChar('*'); 

passTextField.setBounds(insets().left + 85,insets().top + 37,100,22); 

add(passTextField); 

okButton - new java.awt.Button(); 

okButton.setLabel("OK"); 

okButton.setBounds(insets().left + 80,insets().top + 95,40,20); 

add (okButton) ; 

setTitle(""); 

//])) 


AA REGISTER LISTENERS 
SymAction lSymAction = new SymAction(); 
okButton.addActionListener(lSymAction); 
105) 

) 


public PasswordDialog(Frame parent) 
{ 


this (parent, "Username/Password"); 


) 


// Add a constructor for Interactions (ignoring modal) 
public PasswordDialog (Frame parent, boolean modal) 


{ 
this (parent); 


} 


C Add a constructor ior Interactions (ignoring modal) 
public PasswordDialog(Frame parent, String title, boolean modal) 


( 
this(parent, citle); 


} 


public String getUserName () 
{ 


return userTextField.getText(); 


) 


public String getPassword() 


{ 
return passTextField.getText(); 


) 
public void setUserName(String name) 


{ 


userTextField.setText (name); 
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} 


public void setPassword (String pass) 
( 

passTextField.setText (pass); 
) 


public void addNotify() 
( 
// Record the size of the window prior to calling parents addNotify. 
Dimension d = getSize(); 


super.addNotify(); 


if (fComponentsAdjusted) 
return; 


// Adjust components according to the insets 
setsizefinsets().left + insets() right + d.widen, insets |). too t 
insets() bottom * d.beight); 
Component components[] = getComponents(); 
for (int i = 0; 1 < components.length; i++) 
( 
Point p = components{i].getLocation(); 
p.translate(insets().left, insets().top); 
components [i].setlocation(p); 
) 


fComponentsAdjusted = true; 


// Used for addNotify check. 
boolean fComponentsAdjusted = false; 


//((DECLARE CONTROLS 
java.awt.Label nameLabel; 
java.awt.Label passwordLabel; 
java.awt.TextField userTextField; 
java.awt.TextField passTextField; 
java.awt.Button okButton; 

/7}} 


class SymAction implements java.awt.event.ActionListener 


{ 


public void actionPerformed(java.awt.event.ActionEvent event) 


{ 
Object object = event.getSource(); 
if (object == okButton) 
okButton Action(event); 


) 
void okButton Action(java.awt.event.ActionEvent event) 
{ 

// to do: code goes here. 

String uid = getUserName(); 

String password = getPassword(); 


System.out.println("User " * uid * " Password " * password); 


//pass back results to mainFrame 
mainFrame.lookup(uid, password); 


//get rid of the frame 
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hide (); 
dispose); 


} 


IRA ET RADA AA OR FR E e e TT 


// END: passwordDialog.java 


ff ERE REEL e E e EEK EK KK RK ee ee ARA 


O] TIA AAN AR E d er ee XA ek coe RA ee eee A AA 


// File: dbUtil.java 

// Purpose: A utility class object with functions to 

Es establish a connection, submit a SQL Statment, 
ff get database meta data 


PI A x Ec ee EEK KE EKER ERE EX eX x 


Amport Java sql” 
import Java. util.*; //Perevector and hash 
import Jayva:10.*; //for OutputStream 


public class dbUtil | 


private Connection con = null; 
private Statement stmt = null; 
static int sqlRequest = 1; 


private static final boolean debug = false; //for debugging 


JJ RU Kos XN EEE KEE EE SERRE AR eR RR Re eR Kk ek 


JA TEUNction- bool setConnect ion (tema driver, String un 
nA String name, String password) 


// Purpose : constuctor which allows user to specify connection 
f | * khe he hk hehe e hehehe he e he e he eee egeo kk he he ke ehe ee e e e 


public boolean setConnection(Strimg driver, String umi; String name, String 


password) 


{ 


ELSA 
Class.forName (driver); 
con = DriverManager.getConnection(url, name, password); 


}catch (SQLException e) { 
System.out.printlin("Failed to connect to database: " + url +" " 
e.getMessage()); 
return false; 
}catch (ClassNotFoundException e) { 
Sys temsout.printlin( Unaplésto find driver class." ); 
return false; 
} 
System.out.println("Connected to Database :" + url); 
PETUERE 
}//end setConnection 


f | Nee eee de dc 3% dH d d d he de d d H de K d e ehe e d d e d he e e e e ke e he ee EX € 
// Functrion-Meonnection getConnection(String driver, String url, 
17 String name, String password) 


// Purpose : Creates a connection and returns a conneciton object 
f f Fk kk AAA RARA K d H K K K K d *% K K 3% d K *% d $ K d d K K K K K H K d K *% % 


public Connection getConnection(String driver, String url, String name, 
String password) 


{ 
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+ 


try 
Class.forName (driver); 
con = DriverManager.getConnection(url, name, password); 
}catch (SQLException e) { 
System.out.println("Failed to connect to database: " + url + " " + 
e.getMessage()); 
return null; 
}catch (ClassNotFoundException e) { 
SYStEM Out .prigelm (Usable tof ind driver class. E 
return null; 


} 
System.out.printin(”Cennected to Databases Ar uris 


return con; 
)//end setConnection 


] | *k 3k Kk * ke e ke ee e e K e e K K K K K d K d e de K K de de d K RA k % 


// Function: closeConnection ( 
// Purpose : closes the Connection to the datasource 
( [k *k *k *k Kk d * K * Kk K K * 3 K Kk * KH K d K d e ke ck K d A ke e ke ke d Kk K d d * 
public void closeConnection () 
( 
cry, 
con.close(); 


} 
catch (Exception e) | 
e.printStackTrace(); 


) 


)//end closeConnection 


Í | Kk Kk K * ke ck ke ek ke kk e Ck ke ke ke kk de e K d d d d d d de e ck e ke de K d k k 

// Function: executeSQL(String sql) 

// Purpose : dynamically get table data, based upon a sql statment 
ur returns a vector with resultSet 

// Ref: DataBase Programming with JDBC and JAVA 


] | K 3K 3 Ok k e ke ke ke e ok e ke ke ok de de ke kk ck e e ee de K d d ke ke ee d e e ek e kk 


public Vector executeSQL(String sql) 
{ 


Vector resultVector = new Vector(); //to store resultSet by hashTables 


Int Cols; 
try{ 
stmt = con.createStatement (); 


if (stmt.execute (sql) ) { //returns true if sql produces a resultSet 


//get the SQL results 
ResultSet result = stmt.getResultSet(); 


//get the resultSet metadata 
ResultSetMetaData meta = result.getMetaData(); 


//how many columns 
cols = meta.getColumnCount (); 


int xx =0; 
//increment through the rows (tuples) of the result set 
while(result.next() )( 


//each tuple gets a hashtable to store information 
Hashtable rowResults = new Hashtable(cols); 
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//increment through the tuple «name, ssn, dept» 
Go 1 < COLS ALA 


Obyece ob, = result.getObject (1x); 


//use the column lable as the hash key and put object 
hashtable 
if (obj == null) { 
rowResults.put (meta.getColumnLabel (ix), 


} else { 
rowResults.put (meta.getColumnlabel (ix), obj); 


lo vendit 


uo) » 


) 


//add the hash object to the vector 
resultVector.addElement(rowResults); 
)//end while 


return resultVector; 


) 


return null; //SQL statement did not produce a ResultSet 


} 

catch (SQLException e) { 
System.err printin( EarbedOro executeSQL(" $* sse T) function"); 
e.printStackTrace(); 
return null; 


) 


)//end executeSQL 


f f| Fee he heche ehe e hee e ee e e he e e e ehe he hee ede e he he cde ee dece hee hee hehe hehe ehe e e e e e 


// Function : printConsole(Vector v) 

// Purpose : Prints the data taken from hash table which 
D is received by vector v 

f| f[ * * He ke hehehe de he e e H e de de de e ehe he ehe de de e de Se de Se de e e de de de Se de e de de de e he de H H de de e ke H $ 


public void printConsole (Vector v) 
( 
if (v == null) { 
//do nothing 
} 
else ( 
Vector resultVector = v; 
int vectSize = resultVector.size(); 


for(int ix = 0; ix < vectSize; ix++) { 
//take the hashtables from the vector one by one 


Hashtable myHashTable = (Hashtable) resultVector.elementAt (ix); 
//enumerate the objects in hashtable 
Enumeration hashEnum =  (Enumeration)myHashTable.elements(); 
while (hashEnum.hasMoreElements () ) { 

Object myObj = (Object) hashEnum.nextElement(); 


Svstem.out-printlnimyOb3); 
)//end while 


)//end for 


h7 /endeelse 
)//end printHashedVector() 


] | K K” Kk K 3 *% e ee ee ke e e e e de de d Fe e e e coke e ke e de de de d de d e e ke K d ke d e de ke ke 
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// Function"? String convertToString (Vector v) 
// Purpose : Converts Vector into a string with the 
A a delimiator | 
[Of k *k k k k e k e e e Kk k e ke ke k k k k k k ke k d k k % k d k k ke k AAA AA AR 
public String convertResultSetToString (Vector v) 
{ 
if (v == null)( 
//do nothing 
return null; 
} 
else{ 
Vector resultVector = v; 
int vectSize = resultVector.size(); 
StringBuffer buff = new StringBuffer(); 


buff append Ciy 
för(int ix = 0; ix < večtSize; ixte 
//take the hashtables from the vector one by one 
Hashtable myHashTable = (Hashtable)resultVector.elementAt (ix); 
//enumerate the objects in hashtable 
Enumeration hashEnum =  (Enumeration)myHashTable.elements(); 
while (hashEnum.hasMoreElements() ) { 
Object oneItem = (Object) hashEnum.nextElement () ; 
butf.append(" “yy 
buff.append( oneItem.toString() ); 
buff.append(" "); //space between each attribute 


|Z end while 


//a deliminator to be used for printing 
buff.append("l|"); 

//append a newline statement at the end of each tuple 
buff.append ("\n"):; 


fend for 
String result = new String ( buff ); 
return result: 


)//end else 
)//end convertToString() 


f| f| FCR e ee e e e de de de de de de de de de ke de He de de de H d e e de ke K e e e d H e e de d d de ko ke ke ee 


// Function = print VeECctorer Vectors (vector. yv) 


// Purpose : Prints the data taken out of the 2-D vector v 
L First element of the vector is again a vector that contains 
L the name of the attributes 


] | Kk 3k d e ee de de de d He de d de d e e e de d de K de d de d K d d K d d d d K e e ke e kk khe e e e ke 


public static void printVectoro ei vector Vector yV) 
{ 


Vector resultVector = y; 


int vectSize = resultVector.sizel); 

System.out.princin (im printzngesyelcc 

Vector attributeVector = (Vector) resultVector.firstElement (); 
System.out.println("First vector recevied..."); 


//print the name of the attributes of the table 

tor(int xx — 0; xx « attributeVector'sT290) xx++) { 
String attributeName - (String)attributeVector.elementAt (xx); 
System.out.print (attributeName + " ^"); 
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System: out print in 


for(int ix = 1x < vectSize; 1x++) { 
//take the hashtables from the vector one by one 
Vector dataVector = (Vector)resultVector.elementAt (ix); 


for(int yy = 0; yy < dataVector.size(); yytt) { 
Object myObj = (Object) dataVector.elementAt (yy); 
System out println(myObj); 
}//end inner for 
}//end outer for 
)//end printVectorOfVectors() 


f /| * Kk K K % dH *% de de K ke hehe e e he H K d ede he hee he e ehe % H H H dH % d * d e % e ee 


// Function: printResultsTable(ResultSet rs, OutputStream output) 
// Purpose : prints a ResultSet 
// Call: printResultsTable(rs, System.out) 
JU TE KE EE rA OC e ci r ERA ERRE RARA ARE 
PU eo prineResultSsPeble ResultSet rs, OutputStream output) 
throws SQLException =| 
// Set up the output stream 
PrintWriter out = new PrintWriter(new OutputStreamWriter (output) ); 


// Get some "meta data" (column names, etc.) about the results 
ResultSetMetaData metadata = rs.getMetaData(); 


// Variables to hold important data about the table to be displayed 
int numcols = metadata.getColumnCount();// how many columns 
String{] labels = new String[{numcols]; // the column labels 


Lot Mco lvidths — mew amt inumcols] >; // the width of each 
int[] colpos = new int[numcols]; // Start position of each 
inte linewidth; // total width of table 


// Figure out how wide the columns are, where each one begins, 

// how wide each row of the table will be, etc. 

linewidth = 9,77) sor ene initial "|". 

fOr ne a O; i < numcols; i++) { // for each column 
colpos{i] = linewidth; // save its position 
labels [i] metadata.getColumnLabel(it+l); // get its label 
// Get the column width. If the db doesn't report one, guess 
// 30 characters. Then check the length of the label, and use 
// it if it is larger than the column width 


int size = metadata.getColumnDisplaySize(itl); 

if (size == -l) size = 30; // some drivers return -l.. 
int labelsize = labels{i].length(); 

if (labelsize > size) size = labelsize; 

colwidths[{i] = size + 1; // save the column the size 

linewidth += colwidths[i] + 2; // increment total size 


} 


// Create a horizontal divider line we use in the table. 
// Also create a blank line that is the initial value of each 
// line of the table 
StringBuffer divider = new StringBuffer (linewidth) ; 
StringBuffer blankline = new StringBuffer (linewidth) ; 
for(int ai -O i n Pinewldth; 1++) 
divider insert (i, '-'); 
blankline.insert (ïL /#" v"): 
) 
// Put special marks in the divider line at the column positions 
FOR (ne =D rcnumeoels; i++) divider seethaeAc(colpos[i]=1,'+'); 
divider.setCharAt(linewidth-l, '+'); 
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// Begin the table output with a divider line 
cut pcia (divide 


// The next line of the table contains the column labels. 

// Begin with a blank line, and put the column names and column 

// divider characters "|" into it.  overwrite() is defined 

/ /below. 

StringBuffer line - new StringBuffer(blankline.toString()); 

line; setCharAt(0, as 

For (1nt..3 0501 numcols; di MN 
intepos-s colpos[i] * Ll + (colvratas a] labels[i].length ())/2; 
overwrite(line, pos, labels[i]); 
overwrite(line, colpos[i] + colwidths[i], " |"); 


) 


// Then output the line of column labels and another divider 
Out printin (line); 
oùut-prineln(divider); 


// Now, output the table data. Loop through the ResultSet, using 
// the next() method to get the rows one at a time. Obtain the 
// value of each column with getObject(), and output it, much as 
// we did for the column labels above. 


while(rs.next()) { 
line = new StringBuffer(blankline.toString()); 
line.setCharAt (0, '|*55 
for(int i = 0; i < numcols; i++) { 


Object value = rs.getObject(i-*1); 
ve write (line, colposlil + 1, value. toString ().trim())¢ 
overwr3tetline, colpos[i] * colwidths[il, " 1"); 
} 
out printin(line),; 
) 


// Finally, end the table with one last divider line. 
out-println(dividèr); 
oU tZt1usnhOr: 

) 


/** This utility method is used when printing the table of results */ 
Statice vord. Overwrlte (StringButter b, Mar pos, Strang S) 


( 
int len = s.length(); 
for (inc 00,11 <c len; itk) bo setcharar(postis s charAt(i)); 


f f FCR ce ce ee ke eee ek ee RARA RARA Kk Kk aK KK 


// Function: getMetaData(Statemtent stmt) 
// Purpose : outputs the names of the employee 


257 who has consumed the most coffee 
f | 5 N hehe dee he e he e ke he he hehe eee he eee e ke e e he ke ek e e ke he hehe ke ke 


public void getMetaData(ResultSet result) 
( 


ro 
ResultSetMetaData meta - result.getMetaData(); 
int numbers = 0; 


int columns = meta.getColumnCount (); 
for (int i=l;i<=columns;it++) { 
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System eut println (meta.getColumnbabel(i) + "At" 
* meta.getColumnTypeName(i)); 


if (meta.isSigned(i)) ( // is it a signed number? 
numbers++; 
} 
} 
SYsSEém out printin ("Columns: "colin Numeric: 


numbers); 


)catch (Exception e)( 
e.printStackTrace(); 


) 
)//end getMetaData() 


f f * ood ee de hehe hehe hee e e hehe ehe e hehe dee ehe de e hee e ehe ee ke de ke e € 
// Function: getDataBaseMetaData() 


// Purpose : outputs the capabilities of the dbms vendor 


7/5 Source: java.sql.Connection 
VL EDEN AS A ER ERE ee oe KR Roe e se c K A d a RUNS 


public void getDataBaseMetaData() 
( 


ery 
DatabaseMetaData md = con.getMetaData(); 


//there are many questions you can ask, example: 
if (md==nul1)( 


System.out.println("No DataBase Meta Data"); 
) 


else{ 
System.out.println("Database Product :" + 
md.getDatabaseProductName()); 
System.out.println("Allowable Connection :" + 
md.getMaxConnections()); 
SVa cem OUeC Printim SUpport Stored Procedures : "+ 


md.supportsStoredProcedures()); 


System oùt princin ("SOL Support of ODBC Drivers 


SVs cem OLE prne ia E SUpport Core SOL: iit 
md.supportsCoreSQLGrammar()); 


Suspemoout .printlpn("Support Minimum SQDb A 
md. supportsMinimumSQLGrammar ()); 


System out print in( support Extended SORS UL 
md. supportsExtendedSQLGrammar ()); 


Sy ys comtouteprintin" SOL Support of JDBC Drivers’); 


System one printli l Supports ANST 92 Entry: + 
md.supportsANSI92EntryLevelSQL()); 


System.out.println("Supports ANSI 92 Intermediate:" + 
md.supportsANSI92IntermediateSQL()); 


oOvsptembout.praintln('"Supports ANSIS92*PUII:" + 
md.supportsANSI92FullSQL()); 
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} 
eaten (Exception e) 


) 
)//end getDataBaseMetaData() 


[FERRERA 3% e eee eoe de d de de de de Ye de de e e Se ae eee ee ek ee ee ee eke ke 


// Function : printResultSetString(String message) 
// Purpose :Works with above fuction 

] | 3 3k K ARRANCAR AAA AA 
public void printResultSetString(String message) 


( 


//use a string tokenizer to parse the request, the delimiter is 


blankspace 


StringTokenizer tok = new StringTokenizer (message); 


//evaluate the first token "select part from parts" 
String command = tok.nextToken(); 
String from = tok.nextToken(); 


String restOfMsg = restOfMessage (tok); 
StringTokenizer tok2 = new StringTokenizer(restOfMsg, "|"); 
int row = 1; 


int count = 0 


if (message == null) { 
SYStem-OUE.printin( No reules found"); 
jelsel 
count = tok2.countTokens () ; 
forent 1% — 1; 1X < count; 1x++1( 
String result = tok2.nextToken(); 
Svetem cut. printiln("rew" F TOWT cesulc). 
}//end for 


OEEO PEIN MAN MNT Er * "ses bad Resi: Set ***stx c E runc 
}//end else 


Wend function 


O A RE RE RER RER A 


// Function : String restOfMessage(StringTokenizer tok) 
// Purpose :Utility function used by above function 


f /[ * kN eoe ce ee k k kx x kx x k x x k x k x x x x xk k x x x x k k he k k % % % ke ek % % x * 


private String restOfMessage (StringTokenizer tok) 


( 
StringBuffer buff = new Stringauritez (0): 


//get the rest of the request 
while( tok.hasMoreTokens() )( 


buff = buff.append( tok.nextToken() ); //appends the sql statement 
putt puft.appendde  " J); 


String result = new String( buries, 
return result; 


} 


Ju A X Kk EE EK Kov QE NX NE 


// Function: executeSQL(String sql) 
// Purpose : dynamically get table data, based upon a sql statment 


204 


17 returns a vector with resultSet 

// Ref: DataBase Programming with JDBC and JAVA 

f f[ * ek ehe ede RRA ARANA AAA ER 

public String executeSQLGetString(String sql) 

{ 
System.out.println(" executeSQLGetString Request $ " + sqlRequest++); 
String resultString = null; 


tryi 
stmt = con.createStatement (); 


mE cxccutetsqni)t //returns true if sql produces a resultSet 


Resultoce result set = stmt.getResultSet (); 

//put resultSet in string format 

Res iS Ein processResults(resultisecia 
}//end if 


return resultString; 
} 
catch(SQLException e) í 
System.err println("Failed to executeS0OL(" + sql + ") function”); 
e printStackTrace(); 
return null; 


) 


)//end executeSQLGetString(String sql) 


f [| koe e e e e de ee e ehe e ee e eee ee de de e de de de dc e e de e e ee ee e e 


// Function: String processResults(ResultSet results) 

// Purpose : Formats the result set for pretty printing 

[| [ koe e eee ee e e de de de e e ee ee de e de de de e de ke de de ke de de de de de de ke kk eo 

public String processResults(ResultSet results) throws SQLException 
{ 


try { 
ResultSetMetaData meta = results.getMetaData(); 
StringBuffer bar = new StringBuffer(); 


String Durtfrer = ="; 
int cols = meta.getColumnCount (); 
int row count = 0; 


int 1, width = 0; 


// create the bar that is as long as the total of all columns 
forc re-cols; 3-*)- { 
width += meta.getColumnDisplaySize(i); 
) 
width += 1-4 cols; 
for(i=0; i<width; it+) í 
bar.append('-'); 
) 
bar.append('\n'); 
buffer += bar t "|"; 
// After the first bar goes the column labels 
for(i- mi =cols; 1++) A 
StringBuffer filler = new Stringburter(}); 
String label - meta.getColumnLabel(i); 
int size - meta.getColumnDisplaySize(i); 
Ine x; 


// If the label is long than the column is wide, 


// then we truncate the column label 
if( label.length() > size ) { 
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label = label.substring(0, size); 
} 
// If the label is shorter than the column, pad it with spaces 
if( label.length() < size ) { 

inc é 

x = (size-label.length())/2; 

FOr ( JH0; J<x; Jt) { 

filler-append(w) 

} 

label = filler + label + filler; 

1£( label slength() > sizer 


label = label.substring(0, size); 
} 
else { 
while( label.length() < size ) { 
label += " "; 


} 
} 
} 
// Add the column header to the buffer 
buffer = butter + label +. ls 
} 
// Add the lower bar 
buffer = buffer + "\n" + bar; 
// Format each row in the result set and add it on 
while( results.next() ) { 
row count++; 


buffer += "|"; 

// Format each column of the row 

fonur-1. 1€-oo005.93cEt] | 
StringBuffer filler = new StringBuffer(); 
Object value = results.getObject (i); 
int size = meta.getColumnDisplaySize(i); 
String Str = Value. toString); 


Het str.length ze il 
str = str.substring(0, size); 


} 
ii str length() <Fsize) 4 
intoj X; 


x = (size-str.length())/2; 
for(j=0; J<x/ i) 1 
filler. append (=); 


} 
str = filler + str + filler; 
if( str.length() > size) { 
str =" Str.substringi(0, Size); 


) 


else ( 
while( str.length() < size ) { 
str += " ME 
) 
) 
)//end if 
butter = buffer + Sera 
}//end for 


bitters] out ter mit: 
}//end while 


//-Stick a row count up at the top 
if( row count == O ) ( 
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buffer = Nomnuows selected.\n" + buffer: 


} 


else if( row_count == JS 
putres -l urowsselected. Win" « buffer; 
} 
er eni 
buffer = row count + " rows selected.\n" + buffer; 


} 


return buffer; 
}catch( SQLException e ) { 
throw e; 
|]finally 
try ([idresuïcrstclese(); ) 
catchí SOLException e ) { } 
) 


}//end processResults (ResultSet results) 
)//end dbServerUtilities.java 


f f * hh e hee e dee de e he eee he eee hee ee he eee hehe de e ee e e ehe de he EEK 


// END: dbUtil.java 


MI Aux E AM X ede ede Wok ook Xo eo e oU NOx cx ONDE 


E NUR D x Kv oko eoe e eo Kor dro kc ol E c O re gn! 


// File: objectServer.java 
// Purpose: An object that instantiated and binds object to the 
// rmiregistry, making 


f /[ KKK hee e ehe e e ede ehe hehe ee he e e he he e ee e e e ehe e e he e e dece e e ke e de ehe e he e ee e ee e de ee eo 


import java.sql.*; 
import java.util; 
Import Java. ral, 
import java.rmi.server.*; 


public class objectServer 


{ 


f f k*k kk kkk k k k k k k k %« k * k k k k k k k k % k k k k k k k k k k k k k k k k k k k k k k k e de e k k k k x k 3 K x x 


f f FR e k k e e k k k k k k k k e k k k k % % k e d K k K K k Kk K k k k % Kk e k K eee e K K k ke k e Kk ke de K k k k K % K K % * 


// THE MAIN 
public statie void mainiString args[]) 
{ 
CEVA 
//RMISecurityManager security = new RMISecurityManager (); 
System.setSecurityManager(new RMISecurityManager()); 


System.err.printin("\nObject Server binding services..."); 
//bind an acctsdbServer object 
Naming.rebind("acctsdbServer", new acctsdbImpl()); 


System er s acetsdbSsEver.. E 


Naming.rebind ("navydbServer", new navydbImpl ()); 
System.err.println("navydbServer..."); 


Naming.rebind("adminBrokerServer", new dbAdminBroker Impl()); 


System. err.printin("adminBrokerServer...”"); 


Naming.rebind("dbBrokerServer", new dbBroker Impl()); 
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System.out.println("Instantiating the database Broker"); 
System.err.println("dbBrokerServer..."); 


System.err.println("MnObject Server, version 3.1 is ready..."); 


)catch (UnknownHostException e)í( 
System.out.println("Unknown Host Exception " + e); 
)catch(RemoteException e)( 
System.out.println("Remote Exception " + e); 
}catch(java.net.MalformedURLException e) { 
System. out.printin(e); 
}catch (SQLException e) { 
System.out.printin(e); 
} 
}//end main 


}//end objectServer 


f f Kk K K *% K 3< de e K< He dc de d dc de K< He K dc de de de de de e de de de de d e de e de de de de e d K de de de K de de d d de K de K de K d K hee dee d H d dede dee 


// END: objectServer.java 


[ [FERRARI ee he de de de de dece de de de de e e oe e ee de dece e e de e ede oe e de dede e dee de oe dece ode ehe e e oe e hehe e e e e e ke ke 


ff ***** e ehe dee dede e dece dece ede e dece de de He K 46 e deisjeche he e hee de hehe he de de he de e je de de de d d he K 3 e de K K e he ehe dede 


if File: dbAdminBroker Int.java 
// Purpose: Interface for database administrator to enter new users, 


17 authorize them access 
* ce e ode e e eoe eode eoe oe e e oe oe oe oe oe ose e de oe oe oe ose ose je ode oe de oe ode je oe oe oe oe ose oe oe oe oe oe oe oe ose oe oe oe oe oe oce oe oe oe oe oe oe oe oe ose oe ox ov e 
4 


import java mi.: 
import java.sql.*; //for ResultSet 
import java ueil. : //for vecor 


public interface dbAdminBroker Int extends Remote 
: 


//add à user 
public abstract boolean addUser (String name, String password) throws 
RemoteException; 


//delete a user 
public abstract boolean deleteUser (String name) throws RemoteException; 


//allow user access to a datasource 
public abstract boolean provideAccess(String name, String dataSource) throws 
RemoteException; 


//modify user access privileges 
public abstract void deleteAccess(String name, String dataSource) throws 
RemoteException; 


//admin utility 

public abstract Vector getDSNNames()throws RemoteException; 

public abstract boolean addDSN(String name) throws RemoteException; 
public abstract Vector getUsers() throws RemoteException; 

public abstract Vector getDBAccess(String name) throws RemoteException; 


f **kk kk OkoxoROX KR EOKOKSN oko oe ke end ca cd cdd c gd dd d ddd A EAN 


77 END: dbAdminBroker Int.java 


] | 3 * * 3 3 Re *K d de 3< Ae de de de dc de de de K He de e he e dc de de de he de de de de de d be de de 3 he dc de de e Àe dc dc de de he de he ee de de he K Se de de de K K K % 
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UN NUN KO EU en A ER RN RE eK A Ux xe v e oW Ge Se eoe ee 


In Eile: dbAdminBroker Impl.java 
// Purpose: Implementation for database administrator to enter new users, 


T authorize them access 
y ko xk xo x E ER AR KR NK eR Re eee 


import java.-sqgb Eo JDBC 
import java- utik Tor Vector 
import java. rmi; 


import java.rmi.server.*; 
import java.rio-*; 


public class dbAdminBroker Impl extends UnicastRemoteObject implements 
dbAdminBroker Int 
{ 


dbUtil Utilities = null; 
Statement stmt = null; 
Connection con=null; 


f f| FC k k k k k k k k k k k k k k k k KKK KKK KKK ke k k k KR k k e k KR KK x 


//MEUNCEL ON acctsdbimpl( 
// Purpose : object default constructor 
17 must be declared to throw RemoteException 
f j FK Kkkk Kk k k k K k k *k K K k k k k k k k k k k *x k Kk k k k k k k Kk he k k hehe e Kk * e ke 
public dbAdminBroker Impl()throws RemoteException, SQLException 
( 
//create a dbUtil object 
dbUtilities = new dbUtil(); 


Stering driver “eun Oe odossJdbcOdbcDriver"; 
String url "jdbc:odbc:brokerAccess"; 


String uta ; 
String password nu 


con - dbUtilities.getConnection(driver,url,uid,password); 
)//end constructor 


f f ek k K k k k k k k k k k k k k k Kk k k x * * *USER METHODS******k* kk kk *x kk xk x k x x x k x k eode ee % e e e e % * 


//add a user 
public boolean addUser (String name, String password) throws RemoteException 
{ 
//prep the SQL Statement 
StringBurter buff = new StringButter():; 
buff .append ("insert into names values ('"); 
buff.append (name); 
puff ar rpend (= tw) 
buff .append (password) ; 
burtft.appena("')'y. 
String sql = new String (buff); 


System eut println(scgl); 


//submit the statement 

LIN 
Statement stmt = con.createStatement (); 
stmt .executeUpdate (sql); 
Stmt close); 
return true; 

}catch (SQLException ej) { 
Svstem.out.println(e); 
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} 


return false; 


+//fend tune 


//delete a user 3 
public boolean deleteUser(String name) throws RemoteException 


( 


//prep the SQL Statement 

StringBuffer buff - new StringBuffer(); 
buff.append("delete from names where name ='"); 
buff. append (name) ; 

buff.append("'"); 

String sql = new String(buff); 
System out printin(sql); 


StringBuffer Burt l = néw StringBuffer): 


buffl.append("delete from datasources where name ='"); 
buffl.append (name) ; 
buffl;appéne (8); 


String sqli = new String(buff); 
SYStem.out.~prantinisql i); 


//submit the statement 

ELY 
Statement stmt = con.createStatement (); 
stmt.executeUpdate (sql); 
stmt.executeUpdate (sq11); 
stmt.close(); 
return true; 


}catch (SQLException e) { 


System.out.printin(e); 


} 


return false; 


Wena EUnet Ton 


//allow user access to a datasource 
public boolean provideAccess (String name, String dsn) throws RemoteException 


{ 


//prep the SQL Statement 

StringBuffer buff = new StringBuffer(); 
buff.append("insert into datasources values ('"); 
buff.append (dsn); 

buff aopend('"*, =]; 

buff.append (name); 

Burrrappendi" ys 

String sql = new String (butt); 


System. out .printin (sql); 


//submit the statement 

Ervi 
Statement stmt = con.createStatement (); 
stmt .executeUpdate (sql); 
stmt.close(); 
return true; 

}catch(SQLException e) { 
System.out.println(e); 


) 


return false; 


|/7Zend function 
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//modify user access privileges 
public void deleteAccess (String name, String dbase) throws RemoteException 
{ 

//prep the SQL Statement 

StringBuffer buff - new StringBuffer(); 


buff.append("delete from datasources where name ='"); 
buff.append (name) ; 
buff.appeëng("' 57 


buff.append ("and datasource = '"); 
buff.append (dbase) ; 

Duff apprenons) 

String s9 mewfsering (butf); 
System.out.println(sq1l); 


//submit the statement 

ET | 
Statement stmt - con.createStatement(); 
stmt.executeUpdate (sql); 
stmt.close(); 

}catch (SQLException e){ 
Svstem.out.pr-*"ntlníe); 


) 


//return names from name name table 
public Vector getUsers() throws RemoteException 
{ 
Vector ansVect - new Vector(); 
ResultSet rs - null; 


//submit the statement 


tay 
Statement stmt = con.createStatement (); 
rs = stmt.executeQuery ("select name from names" ); 


while (rs.next()) { 
String nameString = rs.getString ("name"); 
ansVect.addElement (nameString) ; 
} 
stmt.close(); 
}catch (SQLException e) { 
System, Out -printin(e); 
return null: 
} 
return ansVect; 
}//getUsers 


//return datasource user has access to, client uses above function to get 
// a list of names 
public Vector getDBAccess (String name) throws RemoteException 
( 
Vector ansVect - new Vector(); 
ResultSet rs - null; 


//prep the SQL Statement 

StringBuffer buff - new StringBuffer(); 

buff.append("select datasource from datasources where name ='"); 
buff.append (name) ; 

Burt append (0), 

String sql = new String (buff); 


System.out-printin(sql); 


//submit the statement 
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tryl 
Statement stmt - con.createStatement(); 
rs = stmt.executeQuery (sql); 
while(rs.next()){ 
String datasource = rs.getString( datasource 95 
System.out:println(dataSource); 
ansVect.addElement (dataSource); 
) 
stmt.close(); 
}catch(SOLException e){ 
System.out.println(e); 
return null; 
) 


return ansVect; 


f | FC e ehe e ce ehe de de e e e de e H e ke 


// Function: Vector getTableName() 


/ / 
// Purpose : uses the database meta data to 
/ / return a vector of table names 


A [ARA AA eoe e e e e e e e de de e e e e e e de dee e e e e e he je eode e eode ode e e e ee 
public Vector getDSNNames()throws RemoteException 
{ 

Vector ansVect = new Vector(); 

ResultSet rs = null; 


//submit the statement 

tnt 
Statement stmt = con.createStatement (); 
rs = stmt.executeQuery("select name from ds"); 
while(rs.next ()) { 

String dsta»ource!- rs.getString(" name"); 

ansVect.addElement (dataSource); 

) . 
stmt.close(); 

)catch (SQLException e)( 
System.ourt printin (e), 
return null; 


) 


return ansVect; 
)//end getDSNNames () 


public boolean addDSN(String name) throws RemoteException 
{ 

//prep the SOL Statement 

StringBuffer butf = new StringBufter(); 

buff .append("insert into ds values ('"); 

buff .append (name) ; 

buff.append("')'); 

String sql = new String (buff); 


System. Oùt printin(sal); 


//submit the statement 
try { 
Statement stmt = con.createStatement (); 
stmt.executeUpdate (sql); 
Stmere ose) > 
return true; 
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}catch (SQLException e) { 
System.out.println(e); 
return false; 


) 


|//end function 


)//end dbAdminBroker Impl.java 


UU Kk kokok k dx A d R9 


A dbAdminBroker Impl.java 


A x ttt C EE Rok e ok o Eoo A r A E r 


UU kk kk kk Kok ee A A Oo EA 


// File: dbBroker Int.java 
// Purpose: Ineterface for generic database access 


PF FEAR RAR ERRE RARA RE RE RARA RAR RRA RARA RARA RARA RARA RARA RRA 


import java.rmi.*; 
import java.sql.*; //for ResultSet 
Import Java. utll.*, //for vecor 


EUDEICOIDrerracesdBBFOKer Int extendsiremats 
{ 

//connection mgmnt 

public abstract boolean createConnection(String dataSource, String 
userName, String pw) throws RemoteException; 

public abstract void closeConnection() throws RemoteException; 


//utilities 

public Vector getTableNames() throws RemoteException; 

public abstract String execcuteSOlGerstring string sql)throws 
RemoteException; 

public abstract Vector getTableMetaData(String sql)throws RemoteException; 
) 


f / EN koc k k k kx k k k xk k k k k k k k k k k k xk k k k k k k k k ec cese RA RARA RARA AAA AAA AAA 


m END: dbBroker Int.java 


[ [RRR RAR RARA RARA RA RARA AAA ARA RRA RARA e ck e e ke e e ek 


[| k Kk * H K K % RARA d he eode ehe ehe ee de he $ d K d % % H d AAA RARA de de d d d ee e ee e ee e d d de $ de K 


Z File: dbBroker Impl.java 


// Purpose: Implementation for generic database broker access 
f f EN ec k k k k k k k k kx k k k k k k k k k k x k k k k k k k k k k k k AAA AA e oe k k k k k k Kk e k e kk kk e % 


import java.sql.*; 

Hnport jJavasutil-*; //for Vector 
Import Java. mim 

import java.rmi.server.*; 

Import java.10.à; 


public class dbBroker Impl extends UnicastRemoteObject 
implements dbBroker Int 
{ 
Statement stmt = null; 
Connection con=null; 
dbUtil dbUtilities = null; 


218 


[[ktkkkk**k*k k k k k k x k kk kx kx x k x k k k k k xk i k k x x k k k kx x k % K *% % * 


// Function: dbBroker_Impl() 
// Purpose : object default constructor 
// must be declared to throw RemoteException 
[PF FEAT ERA Kock eec oes ARA AER A 
public dbBroker Impl()throws RemoteException, SQLException 
( 
//create a dbUtil object 
dbUtilities = new dbUtil(); 
}//end constructor 


Lf FREE AEA ES EE RS RE EE ee ee ee Ee A A 


7// Function: Vector SetConnection (String: detasource, String ura Ste 


password) 
// Purpose : sets the connection to the datasource, returns a vector 
17 containing tablenames 


JIFREREERRERER AE ENAENANAR RE E AE 


public boolean createConnection(String dataSource, String uid, String pw) 
throws RemoteException 


( 


String driver zo Usun.J3dbc:sodbc.JdbcOodbeDELIvert'. 
if(dataSource.equals ("NSGDB")) 
uid = "sa"; 


StringBuffer buff - new StringBuffer(); 
buff sppend('ysd5bc*odbc: 7 
buff.append(dataSource); 

String url = new String(buff); 


con -cdbUtilrities.getConnectrion(drrzver,urli,urid,pw):; 


//get database table name 
return true; 


) 


public void closeConnection() throws RemoteException 
{ 
try ( 
con.close(); 
}catch (SQLException e) { 
System out princinlie); 
} 
} 


JIFRREEERERÉRÉEEEREREERREREEEREREREERÉERERREREREREX 


// Function: executeSQLGetString(String sql 


£A 
// Purpose : user submits SQL statement gets back a string containing 
17 resultSet 


PP ee E A A EE 


public String executeSQLGetString(String sql)throws RemoteException 
{ 


String resultString = dbUtilities.executeSQLGetString (sql); 
return resultString; 
)//end executeSQL 


Jy XR XE KR KE XE Kx EE EEUU Kk A 


// Function: Vector getTableName() 


yt 
// Purpose : uses the database meta data to 
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ur return a vector of table names 


TI ON RAR ERA RAP TE 


public Vector getTableNames() throws RemoteException 
( 
DatabaseMetaData dmd = null; 
ResultSet rs = null; 
Vector ansVect = new Vector(); 
UEM 
dmd = con.getMetaData(); 


String[] types = ("TABLE"); 
rs == Tamatgettables (null, null, "3", types); 


while(rs.next())( 
String tableName = rs.getString("TABLE NAME"); 
ansVect.addElement (tableName); 
) 
}catch (SQLException e) { 
System.out.println(e); 
return null; 


) 


return ansVect; 


) 


f| f| Ce ee e hehe he je ee ehe e de ke ke de de ke ke He He e e e de e he ke de e de de e e k k k K € 


// Function :Vector getTableMetaData (String sql) 


// Purpose : user can submit a SELECT * FROM <table> 

2, to get a list of the column names that exist 

1A to display in a choice list 

// Goal: return a vector of hash tables containing other information 
T such as name, size, type for displaying 


VH Et A T AA E E A DT 7 DZ D A D 7 DA AZ A e he e de be hee be de he e de he e hee 


public Vector getTableMetaData (String sql)throws RemoteException 
{ 
EÉYI 
Statement stmt - con.createStatement(); 
ResultSet results = stmt.executeQuery (sal); 
ResultSetMetaData  rsmd - results.getMetaData(); 
Vector colVect = new Vector(); 
int cols = rsmd.getColumnCount (); 
mess (Minus LX = Ip 1x < cols; 1X>++) 
( 


String colName = rsmd.getColumnName (ix); 


tf (colName == null) 
colName = "was null"; 


f/storemin vector 
colVect.addElement (colName) ; 


//other useful information for displaying results 
int colWidth = rsmd.getColumnDisplaySize(ix); 


//get the columns sql type 
int colType = rsmd.getColumnType (ix); 
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}//end for 
stmt.close(); 

return colVect; 

}catch (SQLException e) { 


SVStemsout .printin ie) ; 
return null: 


} 
Mena funct 


}//end databaseServer 


f | K K 3 3 d d dc He de de dc de d dc de de de de de de e de K w de Se dee ek tee eee ake ke tie te kee K de K de de de de Se de H de ke ee ee ee e $ d $ K 


// END: dbBroker Impl.java 


f / 5 he eee c de de ke ehe eee eee ke dee de e e ehe e ehe e K Ke e he ee eoe hehe ehe e She dese he see hsec Se dc de ke ke ek de K 


f| f| CE e e e hehe e ee hee ee e hee e he e he ke ehe he e e de ede ke e e hehe hehe ehe oie e oie oie ede oe e ecce ee ke ek ee ee ek ek ek 


// Files navydb Int.java 
// Purpose: Hard coded connection to navy database, offers specific 
fe navy database manipulation 


f| | 3k 3 3 K d de 3 3% e de de K e dc K H K e ke ke e e ke ke ke e e de S K de de de de de de de de e de H de de de ke de de ke ke te de Se de de de de de ke e te Se $e $ $ 


import java.rmi.*; 
import java.sqgl.*; //for ResultSet 
import java.util. +; //for vecor 


public interface navydbInt extends Remote 
{ 
I i business logic à 
// returns an object that implements the accessPolicy interface 
public abstract accessPolicy Int getAccessPolicy() throws RemoteException; 


//** database functions ** 

public abstract String executeSQLGetString(String sql) throws 
RemoteException; 

public abstract Vector getTableName ()throws RemoteException; 

public abstract Vector getTableMetaData (String sql)throws RemoteException; 


f| f| NC eee eee he ke ee e e e ehe ee ee e ee eode che e ehe e ee e e ee ee ede eoe ee he e ee e e e ke e e ee ke e ke e e ek kee 


/7 END: navydb Int.java 


[ [RRR ERE Re Re ee ee eek ek eR ek Je cie t ce sk ee e Se eee oe se oie Se Ge ecl e e dese ddd oe che e eee koe 


[| K Kk K * dc ke de hee e de e ke de de de de de de de de d de de de de de de de ke Se Se Se Se de Se de de de de d d d de Se de e Se de de de de ke e e K K e e k e k H e e K 


j/ File: navydb Impl.java 
// Purpose: Hard coded connection to navy database, offers specific 
77 navy database manipulation 


J f| Fk eee k de de de de de de e de de de de de de de de de de de de Se de de de de de de de de de de de de de de de de de de de de de de de Ke K K de H ke d d de ke de e e ke K K 


import java. salen, 

import Java ut P/T ori Vector 
import javac mi =; 

import java.rmi.server.*; 

import eva. 10.0: 
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public class navydbImpl extends UnicastRemoteObject 
implements navydbInt 
( 
Statement stmt = null; 
Connection con=null; 
dbUtil dbUtilitiess— null; 


PAREADAS TN ES EE RARA RARA ARA AAA RAIN 


LI CBunctrenuses cbpoIscv Int getAccessPolrcy0 

// Purpose : Returns a serialized object that contains the 
/ / companies accessLogic 

y *Uxok ENEE AENA G Se e eoe Xe koe ck koX I 

public edeceschelteyeine geltAccessPolicy() 

| 


return new accessPolicyImp(); 


) 


J f| k Kk Kk *+ k de de * ke e ee ee e ee ehe ke ke de de de ke de e ke ke ke ke ke K K e K Kk K K * K K k 


// Bunetion: acctsdbimpl() 
// Purpose : object default constructor 
is must be declared to throw RemoteException 
[ [RR RRR RRR KKK KKK K e e e e e e e de 3 he e ee ke de e de ke ec ee ee e x 
public navydbImpl()throws RemoteException, SQLException 
{ 

//create a dbUtil object 

dbUtilities - new dbUtil(); 


String driver = ‘sun. jdbe.c0dbc.JdbcOdbeDriver'’: 
Stering url = "jdbc: odbc: NSGDB" ; 
String uid = "sa"; 


tt 


oer, 
r 


String password 
con - dbUtilities.getConnection(driver,url,uid,password); 


+//end constructor 


f f| NU e e e e ee e ARA AAA ARA e ke ke e ke ke ke e ke ke eek 


// Function: executeSQLGetString(String sql 


77] 
// Purpose : user submits SQL statement gets back a string containing 
[4 resultSet 


] | Kk K 3 x k k k e K ke K e e ke K * de de de e e K e de ke ehe Kk e ke ke te oe ke ek K Kk 3% k K K 3 k % 
public String executeSQLGetString(String sql)throws RemoteException 
{ 


String resultString = dbUtilities.executeSQLGetString(sql); 
return resultString; 


end erccutesol 


f f| ECC ke e ee ehe ee e de ede e ede ke de d de de de de d d de de d de K d $ ke ke e ke e ke ek 


// Function: Vector getTableName () 


n 
// Purpose : uses the database meta data to 
LA return a vector of table names 


] ] Kk 3 3 ee de d de dc de de de dc de de de de de de de de e de de de de de de d e d e de de de e de de de e ke de ke 


public Vector getTableName()throws RemoteException 
{ 

DatabaseMetaData dmd = null; 

ResultSet rs = null; 

Vector ansVect - new Vector(); 

tryí 
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dmd - con.getMetaData(); 
String[] types = ("TABLE"); 
rs = dmd.getTables (null, null, "4", types); 


Wile (rs .nexet () ){ 
String tableName = rs.getString ("TABLE NAME"); 
ansVect.addElement (tableName) ; 


} 

}catch (SQLException e) { 
System. out .print in (ee); 
return audit; 


} 


return ansVect; 


) 


f / ** ee ede dede he de de de de de de de de de de de de de de de de de de de de de he e e de de de de de d he de H 


// Function :Vector getTableMetaData(String sql) 


// Purpose : user can submit a SELECT * FROM <table> 

LL to get a list of the column names that exist 

/ / to display in a choice list 

// Goal: return a vector of hash tables containing other information 
Edi such as name, size, type for displaying 


A AAA e de de de de de de de de de de de de de de de de de de de de de de de de de de de e de de de de de d de K K 


public Vector getTableMetaData(String sql)throws RemoteException 
{ 


r 

` | stmt = con.createStatement (); 
ResultSet results = stmt.executeQuery (sql); 
ResultSetMetaData rsmd = results.getMetaData(); 
Vector colVect = new Vector(); 
int cols = rsmd.cetColummcoune (|) - 
Corne 1x = 1x <WEOIS; 1x++) 
{ 


String colName = rsmd.getColumnName (1x) ; 


if (colName == null) 
colName = "was null”: 


//store in vector 
colVect.addElement (colName); 


//other useful information for displaying results 
int colWidth - rsmd.getColumnDisplaySize (ix); 


//get the columns sql type 
int colType -» rsmd.getColumnType (ix); 


)//end for 
stmteclose(07j 

return colVect; 

}catch (SQLException e) { 


System.cout.printin(e); 
return null; 
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} 
)//end funct 


)//end databaseServer 


IA AGR AA A A A A E RR Se ole Sek ke le cook X ok eoe TO O O 


ZI END: navydb Impl.java 


Jf * koe he eoe eoe eee dese c e Ge e ie e e e ke e e e e e e e e le e ee e ke ke EE KE KE RER RE RER EX KE e ese 


Jf *** deese eoe e hee ek cene re de ke e ke he se he e KKK KEK keke Kk ke ke e ee eek ke ke RARA A 


V7 Pile: navydb Int.java 


// Purpose: Interface for accounts database, offers client various methods 
JJ e ek AREA EE RAR REIR e e he he e e e e e e de e de de che eoe e e ee dece ce Seele e he e Se ck se hee eoe deco eye 


Ao JAVA. EMI. 
Amport" java. sgl.*;. //for ResultSet 
import Java.util:*; /7for vecor 


public interface acctsdbInt extends Remote 
( 
//returns an object that implements the accessPolicy interface 
public abstract accessPolicy Int getAccessPolicy() throws RemoteException; 


//database function 

//DBA Functions 

public abstract Vector executeSQL(String sql)throws RemoteException; 

public abstract String executeSQLGetString(String sql)throws 
RemoteException; 

public abstract Vector getTableName()throws RemoteException; 

public abstract Vector getTableMetaData(String sql)throws RemoteException; 


//Basic User Functions 

public abstract void insertEmployee(String name, boolean faculty) throws 
RemoteException; 

public abstract String viewEmployees() throws RemoteException; 


//administration functions 
public abstract void addUser(String uid, String pass) throws 
RemoteException; 


) 


] | K 3k *k 4 * 3 de dece e * e e de e e e je ee dede ede e e He He de H de e de de de He de de e ehe de de de de de de e e Je de de de e de ke e de e e e e ke ek 


PREND: acctsdb Impl.java 


f| | K Kk 3 * e H e e e e de de de e e e e de e e He he dede e He H He H de de de He de de ec ede de he de de de ke che de K< He de de de de de de de de de de e de ke ke ke e ke K 


] | FC ek e HORROR de de de de de de de de ke ehe de de de de e e de d He de de de de Se de de e de de ke K de e K e ek 


// File: acctsdb_Impl.java 
// Purpose: Hard coded connection to accounts database, offers limited 
// accounts database manipulation 


|] | K K K * * % H e LL EL e e de de de de de de Je de de H H de e de de de de K de de de de de de e de ke de de ke e de K K de e e de K ke K K ke K K K e ke ke ke Kk 


import. Java.sql.*; 

Enport Java utile //tor Vector 
import java.rmi.*; 

import Jadvacmi.server.*; 


public class acctsdbImpl extends UnicastRemoteObject 
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implements acctsdbInt 


Statement stmt - null; 
Connection con=null; 
dbUt1l dbUtailities = null; 


private boolean debug = true; //for debugging only 


f f Fe ke eee eee e e e e e e e e ke ke e ke KKK KKK KKK KKK 


// Function: accessPolicy Int getAccessPolicy() 
// Purpose : Returns a serialized object that contains the 
"7d companies accessLogic 
f f| FK e k k k k k k k k k k k Kk e ke Kk k k d RR RARA kkk 
püublic accesSsPolicy me getACcCcessPOPc ae 
{ 
return new acctsPolicyImp(); 
) 


//administration functions 
public void addUser(String uid, String pass) throws RemoteException 


( 


/Jnrite into to a file 


} 


[ [Kk *k k Kk he e Kk ke he e H 3% Kk K Kk Kk % $ e ee % e e e e ke k k Kk K k K $ $% d H H d K K à 


// Function: acetsdbImpl() 
// Purpose : object default constructor 
17 must be declared to throw RemoteException 
f f| *k*k*k k k k Kk k k k Kk k k k k Kk k k k k RAR RARA RARA k k d K k K $ k % 
public acctsdbImpl()throws RemoteException, SQLException 
{ 
//create a dbUtil object 
dbUtilities = new dbUtil(); 


String driver - "sun.jdbc.odbc.JdbcOdbcDriver"; 
Seeing rm "jdbc:odbc:acctsDataBase97"; 
SENO ura FEU 

String password 


nn. 
, 


con = dbUtilities.getConnection (driver,url, uid, password) ; 


}//end constructor 


f Nx ke e e ke ke ee eee ehe e he e he e e ke e ke ke e ke ehe e e ke e e e ehe e 


// Function: executeSQL(String sql) 


Ms 

// Purpose : user submits a SQL statement, 

// which processed and returns a vector with resultSet 
// Source: java.sql.Connection 


[/ *kk*k k k k k k k k k e e e e *k k e kk k k k % e kc % k ke X ke k k k e k e e % kk kk 


public Vector executeSQL (String sql)throws RemoteException 
( 

Vector resultVector - new Vector(); 

resultVector = dbUtilities.executeSQL (sql); 


return resultVector; 


)//end executeSQL 
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A AA RE bd p r 

// Function: executeSQLGetString(String sql 

// Purpose : user submits SQL statement gets back a string containing 
t resultSet 


A e eoe e eee e de e e dee e e ede ehe e e e e e de de e e e e ede de e e e e ee e e 
public String executeSQLGetString(String sql)throws RemoteException 
{ 


String resultString = dbUtilities.executeSQLGetString (sql); 
return rTresulest ring, 
}//end executeSQL 


public void insertEmployee(String name, boolean faculty) throws 
RemoteException 
{ 
StringBuffer buff = new StringBuffer (); 
buff.append("insert into People values (' "); 
buff.append (name) ; 
butt aprend (7, ")3; 
buff.append(faculty); 
buff-append('")"); 


String sql = new String(buff); 
String junk = dbUtilities.executeSQLGetString(sql); 


} 


public String viewEmployees() throws RemoteException 


{ 
String result - dbUtilities.executeSQLGetString("select * from People"); 


return result; 
f /[ k oec ede dece ee ee e e e e e ee ee e de e e e e e e e e e e e e e e e e ee & 


// Function: Vector getTableName() 


L 
// Purpose : uses the database meta data to 
i} return a vector of table names 


f [| Fee ee e e ee e ee e ee ee te ee ee e ee de ee e e e he e e e e e ee e e ke 
public Vector getTableName()throws RemoteException 
{ 

DatabaseMetaData dmd = null; 

ResultSet rs = null; 

Vector ansVect - new Vector(); 

Ery 

dmd = con.getMetaData(); 


String[] types = ("TABLE"); 
rs = dmd.getTables (null, null, "$", types); 


while(rs.next())( 
String tableName - rs.getString("TABLE NAME"); 
ansVect.addElement (tableName); 
} 
}catch (SQLException e) { 
System. out.println(e) ; 
return null; 


} 


return ansVect; 
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} 


f f[ NCC ode ke e eode e ke e e RARA e e e e k e ke ke ke e e 


// Function :Vector getTableMetaData(String sql) 


// Purpose : user can submit a SELECT * FROM «table» 
Lh to get a list of the column names that exist 
// to display im a choice dist 


// Goal: return a vector of hash tables containing other information 


4 such as name, size, type for displaying 
f f| KC eoe ce e e hehe k k k k k k k K k k e de k k k k k *k * k k k K k k k k Kk k k k % 


public Vector getTableMetaData(String sql)throws RemoteException 


( 
LEY] : 
Statement stmt - con.createStatement(); 


ResultSet results = stmt.executeQuery (sql); 
ResultSetMetaData  rsmd - results.getMetaData(); 
Vector colVect = new Vector(); 

int cols = rsmad getcolumncount()s 

for(int ix = 17 1x <= cols; 1X++) 

{ 


String colName = rsmd.getColumnName (1x); 


if (colName == null) 
colName = "was null"; 


Store in vector 
colVect.addElement (colName) ; 


//other useful information for displaying results 
Int colWidth = rsmd.getColumnDisplaySize(ix)+; 


//get the columns sql type 
int colType = rsmd.getColumnType (ix); 


ay, onda fOr 
Stmt.close{); 
return colVect; 


}catch (SQLException e) { 
System.out.printin(e); 
return null; 


} 
IN Tena f£unce 


}//end databaseServer 


[ [kkk k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k Kk k k k k Kk k k k k k k k Kk x k k k K Kk k ke ke e ke 


// END: acctsdb Impl.java 


f f 5 5e che hee de e hehe e e e e e e e eoe eoe oe ke he e ee e e e e e e e e e e e e e e e ke ke e ehe e he e ke e e e e e ke e ek e e 


[ [kkk *k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k k Kk e k k Kk K * k k k x * 


// File: accessPolicy Int.java 
// Purpose: Interface to funtions that are implemented by 
1 accessPolicyImp. 
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A A AS A ee ek ER KE 


public interface accesstoliey Int 


( 


public abstract int getAccessCode (String name); 


fof RRR TE A AN AS O A A eee 


/ / END; accessPolicy Int.java 


JU ** ok ARA EN ICON A EEE REAR KAKA ERE EAMES DEO OR deck ole oi we oko 


Wok ook ok ok ENE LAAT AE TREE ERR RARE ON YU OK OUR DKO NUUS Reo 


Ea ler accessPolicyImp 

// Purpose: Contains the current accessPolicy, resides on the server, 
Ly The policy is downloaded to the client, ensures client 

27 uses the current policy. 

// Notes: Object must implement Serializable since the object will be 
77 downloaded to the client via RMI 

// Object runs on client virtual machine, not the servers. 


PURA ARS EAR KAA EAE AERA AK RR RARER EKER EEE KEKE EEA EKER ER EK HR ER 


importe Java. 10."; 


public class 2CcossPolicyimp tM£plements accessPolicy Int, Serializable 


{ 


JERIA RRA che de hehe dece oe he eee oe he he KK Ke 


// Function: int getAccessCode (String name) 
// Purpose: Based upon name, returns current access code 
/ / which sets level of database manipulation 
f | K K K 4 * d * 3 d d d e de e dede e e dece dece de ede e dede dee de K *% 3% e de e dede K H *% 3% K 
public int getAccessCode (String name) 
{ 
int accessCode = -1; 
if (name.equals("dba")) 
accessCode = 1; 
else if(name.equals("fred") ) 
accessCode = 1; 
else if(name.equals("ramis") ) 
accessCode = 1; 
else 
accessCode = 2; 
return accessCode; 


f f| NC ER KR ER KR de de de de de e de de de K de K de ke de de de K K de de deke de de d K de K d d d d de ke e e e d K $ ke 


77 END: accessPolicylmp 


[55x kkk k kek kk k dek keke de de de ke e e de de e K d e ee e e K de de de ke de de ke ke K Kk $ Kk de ke K de de kek ke kek k k K $ Kk e K K e e e ok 
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APPENDIX D. DEPLOYMENT 


A. Deploying Jbuilder database aware Application 

Before explaining the deployment of an application, some assumptions must be 
made concerning about both the development and client environment: 

Classpaths in the JBuilder's IDE settings must be checked in order to point to the 
valid zip or jar files. See JBuilder help files for details. 

If Borland DataGateway is being used, then the classpaths must include the 
location of the file datagateway.zip. To do that, open the JBuilder.ini file and make sure 
that classpath includes datagateway.zip. Also do the same thing for system classpath. 
This is required in order for the Deployment Wizard to gather the appropriate class files 
for setting the connection with the database. 

Client computer has the capability to establish an Internet connection. Before 
running the application, this connection must be established in order to connect to the 
database server. 

Client computer has a Java Runtime Environment (JRE) higher than or equal to 
version 1.1. JRE is the core Java Virtual Machine that allows the applications to run on 
different platforms. If the client environment does not have one, then the user must be 
told to download a JRE from Sun's JRE download page (http://java.sun.com) and to 
install it into his/her computer. 

After satisfying the previous conditions, then follow through the steps to deploy 
the application: 

Create a JBuilder application that uses the Borland DataGateway for connecting 
to a database. 

Before compiling the project, change the OUTPATH in the project settings to 
point to the folder where the projName.jpr file resides. After the compilation, an extra 
directory structure inside the main project folder (the one that JBuilder creates 
automatically when a project is created). The very last folder of this new directory 
structure will contain the class files. If the developer does not change the OUTPATH, 
then JBuilder puts your class files under JBuilder/myClasses/projectName(folder) by 
default. 

Save all of the files in the project and re-build and make sure that the application 
runs in the JBuilder environment by simply clicking the lightning button on the toolbar. 

Bundle the class files into a compressed file by using the Deployment Wizard 
(from the menu bar tools/deployment wizard...). In the Deployment Wizard pop-up frame 
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select the check boxes beside JBCL, JGL and all others options and give a name to the 
file (zip/jar) that will be created by the wizard. But make sure that the path in the file 
window shows the folder that jpr file resides (that 1s, the created jar/zip file will be in the 
same directory with the jpr file). The reason of doing this is just to locate it easily. 

Locate that jar or zip file and locate the broker.zip file (client side of datagateway) 
in the development environment. Broker.zip file contains the necessary class files for 
connecting to the Datagateway server. 

Usually the clients expect to run the applications that they receive without typing 
or modifying anything. In general they just want to click an icon in order to run them. So, 
create a batch file which will contain the exact command line statements to run the 
JBuilder application and tell the client to create a shortcut to that batch file and put it on 
the desktop and run it. 

Make the client create a directory structure necessary for the files that will be sent 
to him/her and let him/her know which file to put where. The batch file should change the 
directories down to where jar or zip file resides and should contain exact commands to 
run the application. The following is an example of a batch file, assuming the client has 
created the desired directory structure (in this case C:\testArealtesti\). And the files 
fName.jar and broker.zip are currently in the test] folder and the name of the class file 
that contains the main method is myMainA pplication. 

RunMe.bat may be like this: 

cd testArealtestl 
jre <p broker.zip ; fName.jar testl.myMainApplication 


Send the following files to the client: 
e Jar or zip file that has been generated by the Deployment Wizard. 
e Broker. zip file that will talk to DataGateway server 
e The batch file 
e A readme text file that explains what directories to create and where 


to put the received files. 


If the user has JDK 1.1 or higher, then the line beginning with jre command inside 
the batch file might just be replaced with "java -classpath .;<exact path to the classes.zip 
of JDK»;broker.zipifName.jar testl.myMainApplication". (Semicolon is used in 
Windows environment, so in unix or linux environment use colon to separate the 
classpath items). User can also modify the classpath of the system by adding the paths to 


broker.zip and fName.jar files into the classpath settings. 
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The user can run this batch file and it will automatically launch the application 
and bring up the GUI. 


B. deploying jbuilder database aware applets 

The followings are the assumptions for a successful applet deployment: 

e Borland DataGateway has been setup correctly. And it runs without an error. 

e System classpath points to datagateway.zip. If not, the user might get "No 
suitable Driver" error during the execution of his/her applet. 

For Windows 95, autoexec.bat file should have the following settings (path 
has to be accurate): 

set classpath = .;c:\Program Files\Borland\Classes\datagateway.zip 

For Window NT machines, in the system properties window the classpath 
system variable must contain the exact path to datagateway.zip file. 

e The classpath in the JBulder'’s IDE options contains datagateway.zip file. If 
not, the user must go to Tools | IDE Options and edit the CLASSPATH, then 
find the zip file in his driver and add it. 

e JBuilder.ini file must be edited for IDECLASSPATH and CLASSPATH to point to 
the file datagateway.zip. If not, the user should open the JBuilder.ini file and add the : 
IDECLASSPATH the exact path of datagateway.zip. The same thing must be done 
for the line beginning with CLASSPATH also. 

e Browsers must be Java enabled. For the time being, Netscape 4.3 and higher versions 
require a Java update (which they call as SmartUpdate). For that you should visit 
Netscape's home page and follow the instructions. Microsoft Internet Explorer 4.0 


and Hot Java are built-in Java enabled. 


After satisfying the previous conditions, then follow through the steps to deploy 
the applet: 

Almost everyone who develops JBuilder applet has the same deployment 
frustration. The following errors are the most common ones: "No suitable Driver” or 
"security.checklink:BDEDriver" or "Applet could not be initialized". Before using the 
Deployment Wizard some code must be changed in order to let the wizard grab those 
class files that are not added into the jar file during the execution of usual Deployment 
Wizard. 

Since we are talking about data-aware applets, there is at least one piece of code 


in your applet that looks like this: 
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databasel.setConnection(new 
borland.jbcl.dataset.ConnectionDescriptor( 
3dbc.BorlemdBroker:/7 290m M IPRC 


"poOrland. 7dbe. Broker. Remeeetiminion sS 


In the above code the driver is not instantiated. So the user must instantiate the 


driver by simply writing the following code before the setConnection function: 
Class.forName("borland.jdbc.Broker.RemoteDriver"); 


Then remove the jdbc driver name from the connectionDescriptor. After making 


these changes your code chunk will look like this: 


Class.forName("borland.jdbc.Broker.RemoteDriver"); 
databasel.setConnection( new 
borland.jbcl.dataset.ConnectionDescriptor ( 
oer omLandeaneker=y, E27 .0.0.1/DB,"";"", false; DE 


Then build your applet and save everything frequently (JBuilder does not save 
your files if you only click the build button) while you are developing. Compile and make 
Sure it runs in the JBuilder environment. Then deploy it by using Deployment Wizard. 
Once it is done, check the jar file (by extracting and re-jaring it) make sure that you have 
the directory structure \borland\jdbc\Broker in there. This indicates that the Deployment 
Wizard grabbed the necessary class files that your applet needed for Borland 
DataGateway connection. 

Modify the html file (but do not change the code tag). Add the archive tag into the 
applet tag. (1.e., <APPLET ... ARCHIVE = "myApplet.jar" ..> </APPLET>). If the 
html file will stay in the same directory with the jar file and you will create a hyperlink to 
that html file in your main page, then you are done. If not or if you want to embed this 
applet directly into your main page without creating a link to 1t, then add the codebase tag 
into the applet tag which should point to the folder where the jar file resides. For 
example, if the path to myApplet.jar is 
C:\InetPub\wwwroot\databases\JBuilder\myApplet and wwwroot is the actual root of 
your web server. Then your html file might look like this: 
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<APPLET 
CODEBASE = "http://131.120.1.91/database/JBuilder/myApplet" 


CODE — "JastApplet.my Applet.class" 
ARCHIVE ="myApplet.jar" 
NAME = "JDBC Database Connectivity Applet" 
WIDTH ="400" 
HEIGHT _ ="125" 
HSPACE ="0" 
VSPACE ="0" 
ALIGN — "middle" 
</APPLET> 


Basically what an applet is just a panel that is being placed onto the html page. 
The dimensions of the panel are hard-coded inside the actual code. The height and the 
width parameters in the html file should match with those hard-coded values. If you 
specify smaller height and width values in the html file, your applet might get cut off 
(that is, you will not be able to see some parts of your applet). 
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